Как я перестала переоформлять документы руками
Мы с моим агентом в Claude Code пишем много рабочих документов: брифы, концепции, оферы. Клиенты с корпоративными привычками любят получать их отдельными гуглдоками. Раньше агент отдавал мне текст в markdown (.md), я переносила его в документ и садилась переоформлять: заголовки синие, абзацы слиплись, шрифт какой попало.
В зависимости от объёма на один документ уходило до 20 минут, и так с каждым файлом. В какой-то момент надоело, и я научила агента оформлять документы так, как привыкла сама ещё со времён работы в агентстве маркетинга. Чистенько, приятно, можно сразу отдавать.
Мои правила оформления
Правил немного, и все они нужны для того, чтобы документ спокойно читался.
| Что | Как |
|---|---|
| Шрифт | Arial, обычное начертание, без жирного: в тексте, заголовках и таблицах |
| Название документа | заголовок первого уровня (H1) |
| Разделы | заголовок второго уровня (H2) |
| Отступы абзаца | 0 pt перед, 10 pt после |
| Списки | 6 pt между пунктами, после последнего 10 pt |
| Выключка | по левому краю, без выравнивания по ширине |
| Таблицы | тот же Arial, в шапке тоже; выключка влево |
Размеры по умолчанию: текст 11 pt, H1 20 pt, H2 16 pt, всё чёрное. Засечки я не люблю, поэтому Arial. Жирный и курсив внутри текста агент оставляет там, где их поставил автор.
Что такое скилл и зачем он здесь
Скилл (skill) — это инструкция, которую агент сам подтягивает, когда видит подходящую задачу. Я один раз описала правила, и теперь, собирая документ, агент применяет их без напоминаний.
| Что | Кому подходит |
|---|---|
| Правила оформления | любому чату с ИИ: вставить в инструкции проекта в ChatGPT или Claude |
| Скилл | агентам, которые умеют работать со скиллами, например Claude Code |
| Скрипт сборки | агентам, которые умеют запускать код |
Первая сборка прошла все проверки и открылась с Times
Первый документ агент собрал, проверил внутренности файла и отдал мне с уверенностью, что всё по правилам. Я открыла его, а там Times вместо Arial и слипшиеся абзацы 🙃
Внутри файла всё было верно. Шрифт и отступы стояли в общих настройках документа, а многие программы для чтения эти настройки игнорируют: Pages, просмотрщик macOS, Google Docs при импорте.
Чтобы оформление не терялось, в скилл добавились три правила для сборки:
- Ставить шрифт, кегль и цвет у каждого фрагмента текста, а отступы и выключку у каждого абзаца, явно.
- Переопределять встроенные стили заголовков (Heading 1, Heading 2): библиотеки по умолчанию делают их синими и жирными.
- В ячейках таблицы ставить отступ после абзаца 0, иначе строки раздуваются.
Как научить агента проверять, что .docx открывается корректно
Главный вывод из этой истории: проверки внутри файла недостаточно. Теперь, прежде чем отдать мне документ, агент делает картинку первой страницы и смотрит на неё: Arial ли, есть ли воздух между абзацами, черны ли заголовки. Как это сделать на macOS и в других системах, записано в скилле. Если отрисовать нечем, агент должен прямо сказать, что внешний вид не проверен.
Самому проверить ещё проще: открыть файл там, где его откроет клиент, например в Word или Google Docs.
Это несколько обнуляет все наши усилия по автоматизации выше, так что пусть лучше проверяет агент.
Скрипт: .docx из markdown
Ту ручную работу, от которой я устала, закрывает скрипт. Он берёт .md и собирает из него .docx: заголовки, списки, таблицы, жирный и курсив. Шрифт и отступы прописывает у каждого абзаца отдельно, поэтому программы для чтения их больше не теряют.
Скрипт лежит в архиве рядом со скиллом. Агенту достаточно сказать «собери .docx из этого файла», остальное он сделает сам по инструкции из скилла. Если запустить скрипт агенту негде, он соберёт файл своими средствами по тем же трём правилам.
Проверено в октябре 2026 на библиотеке docx 9.5.1.
Как подключить скилл к своему агенту
Скачать скилл и скрипт (.zip)- Скачайте архив. Внутри папка со скиллом (
SKILL.md) и скриптом сборки (sborka-docx.js). - Если ваш агент умеет работать со скиллами, положите папку в его папку скиллов. Для Claude Code это
.claude/skills/, подробнее в справке Claude Code о скиллах. - Если работаете в обычном чате, откройте
SKILL.mdи вставьте раздел «Правила» в инструкции проекта в ChatGPT или Claude. - Поменяйте шрифт и отступы под свой вкус: таблица правил в скилле одна, править её просто.