К основному содержанию
скилл CX Codex

generate-swagger-docs — скилл для Claude Code: установка

Скилл generate-swagger-docs для Claude Code сканирует кодовую базу, находит REST-эндпоинты и создаёт спецификацию OpenAPI и интерактивную HTML-документацию. Документирует API.

лицензия не указана 260 установок ★ 50 обновлён 2026-01-05

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add qodex-ai/ai-agent-skills --skill generate-swagger-docs -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/generate-swagger-docs/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/generate-swagger-docs/

По шагам, с командами для каждой платформы: Как установить скилл в 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.

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
generate-api-documentation davila7 Команда generate-api-documentation анализирует код эндпоинтов, находит аннотации и генерирует спецификации OpenAPI, Swagger UI или Redoc. Помогает настроить сборку документации API и шаги в CI/CD. CX Codex +1 1 849установок adding-api-docs spencerpauly Скилл adding-api-docs собирает OpenAPI/Swagger-описание вашего API: схемы эндпоинтов, типы запросов и ответов, интерактивную страницу документации. CX Codex +1 455установок api-docs-generator patricio0312rev Скилл api-docs-generator помогает составить спецификацию OpenAPI и развернуть интерактивную документацию API по кодовой базе. Пригодится при описании эндпоинтов, схем данных и подготовке клиентских SDK. CX Codex +1 411установок api-docs Claude Code Субагент api-docs для Claude Code, который анализирует эндпоинты в коде и составляет спецификацию OpenAPI 3.0 в YAML или JSON. CX Codex ★ 850звёзд репо golang-swagger samber Скилл golang-swagger для Claude Code помогает добавлять и проверять OpenAPI-документацию в Go-проектах через swaggo/swag. Подключается при работе с обработчиками API или кодом, который импортирует пакеты swaggo. CX Codex +1 39 200установок swagger-doc-creator Jeremy Longshore Скилл swagger-doc-creator помогает составлять документацию Swagger и спецификации OpenAPI, настраивать конфигурации и проверять схемы API по стандартам индустрии. CX Codex +1 239установок

Из того же набора42

Весь набор →
chat-with-arxiv Скилл chat-with-arxiv для Claude Code находит статьи на ArXiv, извлекает текст из PDF и отвечает на вопросы по научным публикациям. Помогает проводить обзоры литературы и искать связи между препринтами. CX Codex +1 305установок deep-research-agent Скилл deep-research-agent для Claude Code, Codex, Cursor и других платформ, который автоматизирует сбор данных, проверку источников и составление отчётов. CX Codex +1 290установок autonomous-agent-gaming Скилл autonomous-agent-gaming для Claude Code даёт кодинг-агенту примеры игровых ботов: правила, минимакс, MCTS, Q-learning и шахматы. Агент выбирает ходы в вашей игре. CX Codex +1 274установок rag-agent-builder Скилл rag-agent-builder помогает настроить пайплайн RAG: от нарезки документов и векторизации до гибридного поиска и оценки ответов языковой модели. CX Codex +1 263установок voice-ai-integration Скилл voice-ai-integration собирает голосовое приложение из трёх шагов: распознавание речи, разбор команды, синтез ответа. Примеры на Python для Whisper, Google Cloud, Azure и ElevenLabs. CX Codex +1 211установок presentation-builder Скилл presentation-builder для Claude Code создаёт и редактирует презентации PowerPoint. Он подключается к задачам со слайдами, макетами, анимацией и заметками докладчика. CX Codex +1 203установок llm-fine-tuning-guide Скилл llm-fine-tuning-guide по дообучению языковых моделей через LoRA, QLoRA и полное обновление весов. Помогает настроить обучение под узкую сферу и подготовить датасеты. CX Codex +1 196установок aesthetic-analysis Скилл aesthetic-analysis для Claude Code разбирает визуальный референс и переносит его композицию, цвета и типографику в React Native. Задача — редизайн лендинга по сайту или изображению. CX Codex +1 193установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой