api-documentation-generator — скилл для Claude Code: установка
Скилл сканирует роуты и схемы в кодовой базе и оформляет справочник к REST и GraphQL API. Готовит примеры вызовов, схемы ответов и кодов ошибок.
npx claude-code-templates@latest --skill development/api-documentation-generatorЧто делает api-documentation-generator
Разбирает структуру эндпоинтов прямо по коду проекта. Скилл извлекает методы запросов, заголовки и параметры тела, а затем расписывает валидацию данных и схемы ответов. Пригодится, когда нужно быстро подготовить понятное описание API для внешних команд или обновить устаревшие страницы.
Формирует готовые вызовы для cURL и JavaScript. Скилл также собирает инструкции по авторизации через токены, правилам пагинации и форматам ошибок.
Может подготовить спецификацию OpenAPI или коллекцию для Postman. Для генерации точных примеров нужен доступ к файлам маршрутизации и моделям данных в репозитории.
Какие задачи решает
- описать роуты, параметры и схемы ответов по исходному коду
- составить рабочие примеры вызовов на cURL и JavaScript
- задокументировать коды ошибок и сценарии их решения
- подготовить спецификацию OpenAPI или коллекцию Postman
Примеры запросов агенту
- Изучи эндпоинты в src/routes и создай справочник API с примерами cURL
- Опиши схему авторизации и обнови документацию к методам в api/v1/auth
- Собери спецификацию OpenAPI на основе моделей и контроллеров проекта
Как установить api-documentation-generator
1Через claude-code-templates
npx claude-code-templates@latest --skill development/api-documentation-generator2Через Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill api-documentation-generator -a claude-code3Вручную: положить файлы
~/.claude/skills/api-documentation-generator/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/api-documentation-generator/
Вручную: положить файлы
.agents/skills/api-documentation-generator/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/api-documentation-generator/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates api-documentation-generator2Вручную: положить файлы
.github/skills/api-documentation-generator/SKILL.mdКомандой платформы
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/api-documentation-generatorВручную: положить файлы
.devin/skills/api-documentation-generator/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о api-documentation-generator
Как установить api-documentation-generator в Claude Code?
Выполните команду npx claude-code-templates@latest --skill development/api-documentation-generator в консоли вашего проекта.
С какими типами API работает скилл?
Скилл рассчитан на REST, GraphQL и WebSocket API. Он находит эндпоинты, запросы, подписки и параметры прямо в исходниках.
Какие примеры вызовов генерирует api-documentation-generator?
Создаются сниппеты для cURL, клиентского JavaScript с fetch или axios, а также скрипты на Python с библиотекой requests.
