DOCX
Скилл DOCX предназначен для создания, чтения, редактирования и анализа файлов Microsoft Word DOCX и шаблонов DOTX. Источник отдельно различает рабочие подходы: новый документ предлагается собирать через уже установленный пакет docx, существующий документ редактировать после распаковки ZIP и изменения word/document.xml, а текст читать с помощью pandoc -t markdown. Тот же скилл покрывает изображения, таблицы, оглавления, номера страниц, колонтитулы, find-and-replace, комментарии и tracked changes, поэтому карточка полезна и для простого извлечения текста, и для подготовки оформленного документа. При создании документа есть несколько подтверждённых технических ограничений. Размер страницы по умолчанию A4; для US Letter источник указывает размеры 12240 на 15840 DXA, а для landscape нужно передать портретные размеры вместе с PageOrientation.LANDSCAPE, потому что библиотека сама меняет ширину и высоту. Таблицы требуют одновременно columnWidths у таблицы и width у каждой ячейки, причём значения должны быть в WidthType.DXA и в сумме соответствовать ширине таблицы. Для заливки используется ShadingType.CLEAR, а не SOLID. Списки создаются через numbering с LevelFormat.BULLET, символ bullet нельзя вставлять вручную. ImageRun требует поле type, PageBreak должен находиться внутри Paragraph, а переносы строк нужно выражать отдельными Paragraph вместо . Для навигации по документу источник рекомендует встроенные HeadingLevel, иначе пользовательское оформление без outlineLevel не попадёт в оглавление. Горизонтальную линию следует делать нижней границей Paragraph, не таблицей. Для точек-лидеров и правого выравнивания на одной строке используется PositionalTab с соответствующим leader, а не набор точек или пробелов. Эти правила особенно важны для документов, которые должны одинаково открываться в Word и Google Docs: они уменьшают риск сломанной ширины таблицы, неверных списков и невидимого оглавления. Редактирование существующего DOCX требует осторожности: файл нужно распаковать, удалить symlink-записи как недоверенные, при необходимости объединить фрагменты текста скриптом merge_runs.py, изменить XML без переформатирования и собрать ZIP обратно. Для tracked changes скилл требует w:ins и w:del с автором, датой и идентификатором, а удалённый текст хранится в w:delText; для комментариев предлагается helper comment.py, который создаёт связанные XML-файлы и выдаёт маркеры для document.xml. После записи результат нужно преобразовать в PDF через soffice, отрендерить страницы pdftoppm и проверить глазами; XML можно валидировать scripts/office/validate.py. Скилл не является конвертером всех офисных форматов и не заменяет визуальную проверку сложной разметки.
Для чего подходит
- Создание документов Word
- Редактирование DOCX
- Комментарии и tracked changes
Установка
Сначала прочитайте SKILL.md и scripts в исходном репозитории. Затем выполните команду в каталоге проекта:
npx skills add https://github.com/anthropics/skills/tree/main/skills/docx