generate-swagger-docs — скилл для Claude Code: установка
Скилл generate-swagger-docs для Claude Code сканирует кодовую базу, находит REST-эндпоинты и создаёт спецификацию OpenAPI и интерактивную HTML-документацию. Документирует API.
лицензия не указана 260 установок ★ 50 обновлён 2026-01-05
npx skills add qodex-ai/ai-agent-skills --skill generate-swagger-docs -a claude-codeЧто делает generate-swagger-docs
Скилл анализирует репозиторий, определяет веб-фреймворк и собирает описание найденных API-эндпоинтов. На выходе появляются OpenAPI 3.0 в apimesh/swagger.json и автономная HTML-документация в apimesh/apimesh-docs.html, которую можно открыть или передать коллегам.
Внутри используется скрипт-обёртка, который принимает ключ, подготавливает каталог apimesh и запускает инструмент apimesh. Поддерживаются Django, Flask, FastAPI, Express, NestJS, Rails и Go. Фреймворк можно определить автоматически или задать вручную.
Для анализа нужен ключ OpenAI. Настройки сохраняются в apimesh/config.json, поэтому этот файл нужно добавить в .gitignore: в нём могут находиться секреты. Без ключа OpenAI генерация документации не запустится.
Какие задачи решает
- найти API-эндпоинты в репозитории
- собрать OpenAPI 3.0-спеку
- создать интерактивную HTML-документацию
- определить веб-фреймворк проекта
- сохранить настройки запуска в
apimesh/config.json
Примеры запросов агенту
- Проанализируй репозиторий и создай документацию для всех API-эндпоинтов.
- Собери OpenAPI-спеку проекта в
apimesh/swagger.jsonи HTML-документацию рядом с ней. - Определи фреймворк API и запусти генерацию через
generate-with-key.shс моим ключом OpenAI.
Как установить generate-swagger-docs
1Через Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill generate-swagger-docs -a claude-code2Вручную: положить файлы
~/.claude/skills/generate-swagger-docs/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/generate-swagger-docs/
1Через Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill generate-swagger-docs -a codex2Вручную: положить файлы
.agents/skills/generate-swagger-docs/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill generate-swagger-docs -a cursor2Вручную: положить файлы
.cursor/skills/generate-swagger-docs/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install qodex-ai/ai-agent-skills skills/generate-swagger-docs2Вручную: положить файлы
.github/skills/generate-swagger-docs/SKILL.md1Через Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill generate-swagger-docs -a gemini-cli2Командой платформы
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/generate-swagger-docsВручную: положить файлы
.devin/skills/generate-swagger-docs/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill generate-swagger-docs -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о generate-swagger-docs
Как установить generate-swagger-docs в Claude Code?
Выполните npx skills add qodex-ai/ai-agent-skills --skill generate-swagger-docs -a claude-code, затем используйте файл ~/.claude/skills/generate-swagger-docs/SKILL.md.
Что делает generate-swagger-docs?
Скилл ищет API-эндпоинты в коде, определяет фреймворк и создаёт OpenAPI 3.0 в apimesh/swagger.json, а также HTML-документацию в apimesh/apimesh-docs.html.
Что нужно для работы скилла?
Нужен ключ OpenAI для анализа кода. После запуска настройки сохраняются в apimesh/config.json, который следует добавить в .gitignore.