article-writing
Когда использовать
Когда есть подтверждённая тема (approve-theme прошёл) и research-пакет, и нужно получить master-draft статьи — единый длинный markdown-файл, который потом адаптируется под платформы (vc.ru, Дзен, Telegram). НЕ используй этот скилл для коротких постов (<500 слов), маркетинговых тизеров, твитов — у них своя структура и тон.
Основной workflow (5-7 шагов)
- Прочитай research-пакет (выдаётся routine'ой как input). Если нет — останавливайся и проси research-агента.
- Построй outline — структура из 3–7 секций. Сверяйся с
references/structure-template.md(intro → body → CTA). - Напиши draft по outline. Для каждой секции — конкретные тезисы из research. Не выдумывай факты, не подтверждённые источниками.
- Самопроверка тона. Сверь с
org/brand-voice.md(он автоматически в твоём system prompt от runtime) +references/tone-of-voice.md. - SEO-минимум. Сверь с
references/seo-basics.md: один H1, 2+ H2, lead 100–250 символов, meta description если требует target-платформа. - Длину проверь скриптом:
Скрипт вернёт JSONpnpm exec tsx skills/article-writing/scripts/word-count-check.ts <path> [--min N] [--max M]{wordCount, charCount, status: 'ok'|'too-short'|'too-long'}. Дефолтный диапазон: 1000–3000 слов. - Финальный чек-лист (см. ниже) и сдача артефакта.
Что обязательно проверить перед сдачей
- Все факты из research имеют ссылку (или явно помечены как «свой опыт»)
- Один H1, минимум 2 H2
- Lead-параграф 100–250 символов
- Brand-voice выдержан (никаких корпоративных штампов, см.
references/style-guide.md) - Длина в диапазоне 1000–3000 слов (или явно обоснован выход за рамки)
- Есть финальный CTA (подписка / следующий пост / комментарии)
Подробности
Большие пакеты знаний разнесены по references/:
- structure-template.md — каркас статьи
- style-guide.md — формулировки и табу
- seo-basics.md — H1/H2/meta правила
- tone-of-voice.md — голос (поверх org/brand-voice)
- research-protocol.md — как обращаться с источниками
- examples/good-article-1.md — образец
- examples/what-not-to-do.md — антипаттерны
Читай только нужное — на простой статье достаточно structure-template + style-guide.