w-docs — скилл для Claude Code: документация и установка
Скилл w-docs для Claude Code обновляет документацию проекта после изменения кода или функции. Он выбирает слой документации по типу изменения.
MIT 647 установок ★ 1 обновлён 2026-10-02
npx skills add blockmatic-icebox/basilic-skills --skill w-docs -a claude-codeЧто делает w-docs
w-docs обновляет документацию в том слое проекта, которому принадлежит изменение. Для архитектуры, команд и процессов он ищет подходящий раздел технической документации и существующую тематическую страницу; новую создаёт, только если подходящей нет. Каноническое объяснение правит в MDX.
README меняется только при изменении запуска, настройки или скриптов, а правило агента — если поменялось ограничение, которое нельзя нарушать. Скилл следует правилам документации репозитория и не дублирует MDX в README или правилах. Коммит не делает без просьбы.
Для перемещения файлов он предлагает краткий список путей «откуда — куда». Сохранить его можно только при заданном пути, а перемещать файлы — только если вместе с этим поручена реализация.
Какие задачи решает
- обновить техническую документацию после изменения архитектуры
- добавить описание новой команды или процесса в существующую MDX-страницу
- синхронизировать README с изменениями запуска и настройки
- поправить правило агента после смены обязательного ограничения
Примеры запросов агенту
- Обнови документацию для этой функции в подходящем слое проекта.
- Добавь новую команду в существующую MDX-страницу и обнови README со ссылкой.
- Предложи список перемещения этих файлов, но не перемещай их.
Как установить w-docs
1Через Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-docs -a claude-code2Вручную: положить файлы
~/.claude/skills/w-docs/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/w-docs/
1Через Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-docs -a codex2Вручную: положить файлы
.agents/skills/w-docs/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-docs -a cursor2Вручную: положить файлы
.cursor/skills/w-docs/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install blockmatic-icebox/basilic-skills skills/workflow/w-docs2Вручную: положить файлы
.github/skills/w-docs/SKILL.md1Через Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-docs -a gemini-cli2Командой платформы
gemini skills install https://github.com/blockmatic-icebox/basilic-skills --path skills/workflow/w-docsВручную: положить файлы
.devin/skills/w-docs/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-docs -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о w-docs
Как установить w-docs в Claude Code?
Выполни npx skills add blockmatic-icebox/basilic-skills --skill w-docs -a claude-code. Файл скилла находится по пути ~/.claude/skills/w-docs/SKILL.md.
Что делает w-docs?
Он обновляет документацию в слое, который отвечает за изменённую часть проекта: технические страницы, README или правила агента. Новую MDX-страницу создаёт, только если не подходит существующая.
Когда w-docs меняет README или правила агента?
README он правит при изменениях запуска, настройки или скриптов. Правило агента — когда меняется ограничение, которое агент должен соблюдать.
Исходный текст
SKILL.md · MIT
--- name: w-docs description: Document the current code or feature in the owning docs layer. disable-model-invocation: true --- Document the current code or feature. Follow the consuming repo's docs and README rules. Do not commit unless asked. Durable information architecture belongs in existing MDX; do not invent a second sitemap. Write to the layer that owns the change: | Layer | Role | Update when | | --- | --- | --- | | Technical docs (path in `AGENTS.md`) | Architecture, ADRs, how-to | Behavior, architecture, commands, conventions, or workflow changed | | Agent rules | Short constraints | A convention the agent must not violate changed | | Nearest README | How to run this app/package; links only | Scripts, setup, or package purpose changed | Inline comments only when the code is otherwise misleading. Do not copy MDX into rules or READMEs. Do not `@`-attach MDX. 1. Identify the matching docs section, then an existing topic page (create a page only if none fits). 2. Write or patch MDX if the canonical explanation changed. 3. Patch README only for run/setup/scripts; link the MDX. 4. Patch the glob-matched rule only if a constraint changed. 5. For mechanical file or doc moves: propose the smallest from/to list grouped by related files; drop folder-name prefixes inside groups. Save only if the user gave a path. Do not move files unless they also asked to implement.
© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills