w-api-docs — скилл для Claude Code: обновление API-документации
Скилл w-api-docs для Claude Code обновляет API-документацию из исходной схемы или маршрутов. Он подключается к задаче, когда нужно изменить API и пересобрать его документацию.
MIT 647 установок ★ 1 обновлён 2026-10-02
npx skills add blockmatic-icebox/basilic-skills --skill w-api-docs -a claude-codeЧто делает w-api-docs
w-api-docs обновляет API-документацию через исходную схему или маршруты, а не правит сгенерированные файлы вручную. Сначала скилл предлагает прочитать MDX-документацию и README генератора, найти источник схемы и скрипт генерации в package.json.
Изменения вносятся в схему или маршрут, затем запускается описанная в проекте команда генерации. Если в репозитории есть скрипты проверки расхождений, их тоже нужно запустить. Сгенерированные OpenAPI-файлы, клиенты и SQL напрямую не редактируются.
MDX-файлы для потребителей API обновляются только при изменении поведения. Скилл не должен придумывать правила авторизации, ограничения частоты запросов или версионирования. Если изменились поведение или команды, документацию можно обновить через /w-docs.
Какие задачи решает
- обновить API-документацию после изменения схемы или маршрута
- пересобрать OpenAPI из исходного источника
- проверить расхождения между схемой и сгенерированными файлами
- синхронизировать MDX для потребителей API с новым поведением
Примеры запросов агенту
- Обнови документацию API после изменения маршрута Fastify и запусти генератор из
package.json. - Измени схему TypeBox и пересобери OpenAPI, не редактируя сгенерированные файлы.
- Синхронизируй MDX для потребителей API с изменившимся поведением.
Как установить w-api-docs
1Через Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-api-docs -a claude-code2Вручную: положить файлы
~/.claude/skills/w-api-docs/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/w-api-docs/
1Через Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-api-docs -a codex2Вручную: положить файлы
.agents/skills/w-api-docs/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-api-docs -a cursor2Вручную: положить файлы
.cursor/skills/w-api-docs/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install blockmatic-icebox/basilic-skills skills/workflow/w-api-docs2Вручную: положить файлы
.github/skills/w-api-docs/SKILL.md1Через Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-api-docs -a gemini-cli2Командой платформы
gemini skills install https://github.com/blockmatic-icebox/basilic-skills --path skills/workflow/w-api-docsВручную: положить файлы
.devin/skills/w-api-docs/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-api-docs -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о w-api-docs
Как установить w-api-docs в Claude Code?
Выполни npx skills add blockmatic-icebox/basilic-skills --skill w-api-docs -a claude-code, затем установи скилл по пути ~/.claude/skills/w-api-docs/SKILL.md.
Что делает w-api-docs?
Скилл обновляет API-документацию из исходной схемы или маршрутов и запускает документированную команду генерации. Сгенерированные OpenAPI-файлы, клиенты и SQL он не предлагает менять вручную.
Какие файлы меняет w-api-docs?
Изменения вносятся в исходную схему или маршрут. MDX для потребителей API обновляется только при изменении поведения; сгенерированные файлы напрямую не редактируются.
Исходный текст
SKILL.md · MIT
--- name: w-api-docs description: Refresh API docs from the owning schema source; never edit generated OpenAPI by hand. disable-model-invocation: true --- Update API documentation from the source of truth (TypeBox/Fastify routes, or the repo's documented generator). Never edit generated OpenAPI, generated clients, or generated SQL directly. 1. Read the API docs MDX and the generator README. Identify the owning source and the generate script in package.json. 2. Change the owning schema or route, not the generated artifact. 3. Run the documented generate command. Check drift scripts if the repo has them. 4. Update adopter MDX only for behavior that changed. Do not invent auth, rate-limit, or versioning policy. 5. Docs: `/w-docs` if behavior or commands changed.
© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills