draft-openspec-docs

Что делает навык

Навык предназначен для совместного создания и редактирования документации OpenSpec в режиме итеративного черновика. Он позволяет агенту строить план страницы, согласовывать его с пользователем и последовательно писать разделы, соблюдая стилистические нормы.

Когда применять

• Создание новой страницы документации с нуля
• Полное переписывание существующей страницы документации
• Структурирование и планирование контента перед написанием текста

Как работает

1. Загрузить файлы write-openspec-docs (как источник стиля) и no-ai-slop перед началом работы.
2. Оставить на странице только заголовок и строку цели (goal line), удалив остлой контент.
3. Добавить раздел '## Scratch: page plan (delete before publish)' для черновика.
4. Заполнить подраздел '### Purpose' (3–5 пунктов: целевая аудитория, охват, ссылки), сверившись с docs-lab/README.md и docs-lab/message-map.md.
5. Заполнить подраздел '### Structure' нумерованным списком секций страницы с указанием формата контента (таблица, блок кода, дерево, списки).
6. Взаимодействовать с пользователем для утверждения плана, затем писать разделы по одному.

Примеры запросов агенту

Что понадобится

• Доступ к файлам write-openspec-docs, no-ai-slop, docs-lab/README.md, docs-lab/message-map.md

Описание составлено по SKILL.md навыка, сверено 09.10.2026.

Как подключить

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.