swagger-doc-creator — скилл для Claude Code
Скилл swagger-doc-creator помогает составлять документацию Swagger и спецификации OpenAPI, настраивать конфигурации и проверять схемы API по стандартам индустрии.
MIT 239 установок ★ 2 935 обновлён 2026-11-01
npx skills add jeremylongshore/tons-of-skills-marketplace --skill swagger-doc-creator -a claude-codeЧто делает swagger-doc-creator
Скилл автоматизирует работу с документацией Swagger и проектированием API. Агент даёт пошаговые инструкции, генерирует готовый код и файлы конфигурации, а затем сверяет получившуюся схему с общими стандартами спецификации.
Для работы ассистент использует встроенные инструменты: чтение, запись и правку файлов через Read, Write и Edit, поиск через Grep, а также сетевые запросы curl в консоли. Доступ к терминалу ограничен только утилитой curl, поэтому другие команды скилл не выполнит.
Без предварительно настроенного окружения и доступа к файлам проекта генерация завершится ошибкой.
Какие задачи решает
- составить спецификацию OpenAPI и Swagger для рабочего API
- сгенерировать конфигурационные файлы документации
- проверить параметры схемы API на наличие обязательных полей
Примеры запросов агенту
- Помоги настроить swagger doc creator для нашего REST API
- Сгенерируй спецификацию Swagger по текущим маршрутам проекта
- Проверь схему OpenAPI на соответствие стандартам
Как установить swagger-doc-creator
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill swagger-doc-creator -a claude-code2Вручную: положить файлы
~/.claude/skills/swagger-doc-creator/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/swagger-doc-creator/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill swagger-doc-creator -a codex2Вручную: положить файлы
.agents/skills/swagger-doc-creator/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill swagger-doc-creator -a cursor2Вручную: положить файлы
.cursor/skills/swagger-doc-creator/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jeremylongshore/tons-of-skills-marketplace skills/15-api-development/swagger-doc-creator2Вручную: положить файлы
.github/skills/swagger-doc-creator/SKILL.md1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill swagger-doc-creator -a gemini-cli2Командой платформы
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/15-api-development/swagger-doc-creatorВручную: положить файлы
.devin/skills/swagger-doc-creator/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill swagger-doc-creator -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о swagger-doc-creator
Как установить swagger-doc-creator в Claude Code?
Выполните команду npx skills add jeremylongshore/tons-of-skills-marketplace --skill swagger-doc-creator -a claude-code. Файл спецификации сохранится в каталоге ~/.claude/skills/swagger-doc-creator/SKILL.md.
Что делает скилл swagger-doc-creator?
Он генерирует конфигурации документации Swagger, помогает описывать эндпоинты API и проверяет разметку на соответствие стандартам.
Какие инструменты разрешены скиллу в сессии?
Скилл запрашивает права на чтение, запись и правку файлов через Read, Write и Edit, поиск по тексту с помощью Grep, а также сетевые запросы через Bash(curl:*).
Исходный текст
SKILL.md · MIT
--- name: swagger-doc-creator description: 'Create swagger doc creator operations. Auto-activating skill for API Development. Triggers on: swagger doc creator, swagger doc creator Part of the API Development skill category. Use when working with swagger doc creator functionality. Trigger with phrases like "swagger doc creator", "swagger creator", "swagger". ' allowed-tools: Read, Write, Edit, Bash(curl:*), Grep version: 1.0.0 license: MIT author: Jeremy Longshore <[email protected]> tags: - api - development compatibility: Designed for Claude Code --- # Swagger Doc Creator ## Overview This skill provides automated assistance for swagger doc creator tasks within the API Development domain. ## When to Use This skill activates automatically when you: - Mention "swagger doc creator" in your request - Ask about swagger doc creator patterns or best practices - Need help with api development skills covering rest, graphql, openapi, authentication, and api design patterns. ## Instructions 1. Provides step-by-step guidance for swagger doc creator 2. Follows industry best practices and patterns 3. Generates production-ready code and configurations 4. Validates outputs against common standards ## Examples **Example: Basic Usage** Request: "Help me with swagger doc creator" Result: Provides step-by-step guidance and generates appropriate configurations ## Prerequisites - Relevant development environment configured - Access to necessary tools and services - Basic understanding of api development concepts ## Output - Generated configurations and code - Best practice recommendations - Validation results ## Error Handling | Error | Cause | Solution | |-------|-------|----------| | Configuration invalid | Missing required fields | Check documentation for required parameters | | Tool not found | Dependency not installed | Install required tools per prerequisites | | Permission denied | Insufficient access | Verify credentials and permissions | ## Resources - Official documentation for related tools - Best practices guides - Community examples and tutorials ## Related Skills Part of the **API Development** skill category. Tags: api, rest, graphql, openapi, swagger
© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace