clarify-docs — скилл для Claude Code: что делает и как установить
Скилл clarify-docs улучшает документацию, черновики PR и описания issue, сохраняя исходный смысл. Подходит, когда нужно привести текст в порядок, а не менять код.
лицензия не указана ★ 155 обновлён 2026-10-29
npx skills add serpro69/claude-toolbox --skill clarify-docs -a claude-codeЧто делает clarify-docs
clarify-docs редактирует выбранный локальный файл с документацией, черновик PR или issue. Он может работать с вставленным текстом и удалёнными URL, если задано место для сохранения результата. Скилл учитывает читателя, цель, требования и исходные материалы, а затем проверяет, понятно ли описание и сохранены ли важные детали.
Внутри есть обязательная последовательность: сначала загружается shared-document-clarity.md, затем выбираются артефакт, читатель и место назначения. После этого скилл изучает связанную работу, редактирует полный путь чтения и выполняет проверку. Каталог помогает найти нужный файл, но не запускает массовую переработку.
Код, конфигурация, AGENTS.md, CLAUDE.md и другие инструкции сюда не входят. Запрос на их редактирование получает предложение использовать $kk:implement без автоматического запуска. Один URL без явной редакторской задачи тоже требует уточнения.
Какие задачи решает
- уточнить документацию для конкретного читателя
- переписать черновик PR, сохранив исходный смысл
- привести описание issue к понятной структуре
- сохранить отредактированный текст в выбранный локальный файл
Примеры запросов агенту
- Запусти
$kk:clarify-docsдляdocs/configuration.mdдля владельцев сервиса, используйsrc/config/. - Улучши
pr-draft.mdдля ревьюеров репозитория и сохрани факты из PR base/head. - Обработай URL issue и сохрани исправленное описание в
docs/feat/wip/import/issue-draft.md.
Как установить clarify-docs
1Через Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill clarify-docs -a claude-code2Вручную: положить файлы
~/.claude/skills/clarify-docs/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/clarify-docs/
1Через Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill clarify-docs -a codex2Вручную: положить файлы
.agents/skills/clarify-docs/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill clarify-docs -a cursor2Вручную: положить файлы
.cursor/skills/clarify-docs/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install serpro69/claude-toolbox kodex-plugin/skills/clarify-docs2Вручную: положить файлы
.github/skills/clarify-docs/SKILL.md1Через Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill clarify-docs -a gemini-cli2Командой платформы
gemini skills install https://github.com/serpro69/claude-toolbox --path kodex-plugin/skills/clarify-docsВручную: положить файлы
.devin/skills/clarify-docs/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о clarify-docs
Как установить clarify-docs в Claude Code?
Выполните npx skills add serpro69/claude-toolbox --skill clarify-docs -a claude-code, затем проверьте файл ~/.claude/skills/clarify-docs/SKILL.md.
Что делает clarify-docs?
Скилл редактирует документацию, черновики PR и описания issue с учётом читателя, цели и исходных материалов. Результат сохраняется локально, а смысл исходного текста должен сохраняться.
Можно ли с его помощью изменить AGENTS.md или код?
Нет, такие файлы и задачи находятся за пределами этого скилла. Для явного запроса на редактирование инструкций он предлагает $kk:implement, но сам его не запускает.