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

swagger-doc-creator — скилл для Claude Code

Скилл swagger-doc-creator помогает составлять документацию Swagger и спецификации OpenAPI, настраивать конфигурации и проверять схемы API по стандартам индустрии.

MIT 239 установок ★ 2 935 обновлён 2026-11-01

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill swagger-doc-creator -a claude-code
Открыть на GitHub

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

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

~/.claude/skills/swagger-doc-creator/SKILL.md

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

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

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

Все скиллы по теме «Бэкенд и API» →
doc-api davila7 Команда doc-api для Claude Code генерирует документацию API по кодовой базе проекта. Она находит маршруты, контроллеры и схемы данных, формируя спецификации OpenAPI или интерактивный Swagger UI. CX Codex +1 733установок api-reference-documentation aj-geddes Скилл api-reference-documentation помогает агенту собрать справочник по API: эндпоинты, аутентификация, примеры запросов и ответов, спецификация OpenAPI. CX Codex +1 501установок doc-generator luongnv89 Скилл doc-generator читает исходники и собирает документацию API: спецификации OpenAPI, описания эндпоинтов, примеры на cURL, JavaScript и Python. CX Codex +1 ★ 47 494звёзд репо swagger-contract-testing-openapi-parser pactflow Плагин swagger-contract-testing-openapi-parser для Claude Code разбирает OpenAPI и генерирует тесты на дрейф контракта. Сопоставляет API-контракт с тестовым сценарием. ★ 7звёзд репо golang-swagger samber Скилл golang-swagger для Claude Code помогает добавлять и проверять OpenAPI-документацию в Go-проектах через swaggo/swag. Подключается при работе с обработчиками API или кодом, который импортирует пакеты swaggo. CX Codex +1 39 200установок generate-swagger-docs qodex-ai Скилл generate-swagger-docs для Claude Code сканирует кодовую базу, находит REST-эндпоинты и создаёт спецификацию OpenAPI и интерактивную HTML-документацию. Документирует API. CX Codex +1 260установок

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

Весь набор →
tracking-crypto-prices Скилл tracking-crypto-prices для Claude Code и пяти других AI-платформ: получает текущие и исторические цены 10 000+ монет через CoinGecko и yfinance. Запускается по фразам вроде «курс BTC» или «покажи топ-10 монет». CX Codex +1 345установок readme-generator Скилл для автоматической генерации README-файлов в проектах. Активируется по фразе «readme generator» или «readme» в запросе. CX Codex +1 273установок n8n-workflow-generator Скилл n8n-workflow-generator генерирует готовые конфигурации и шаги для сценариев n8n в рамках автоматизации процессов. Срабатывает при упоминании n8n в диалоге с ассистентом. CX Codex +1 271установок consul-service-discovery Скилл consul-service-discovery помогает настроить обнаружение сервисов через Consul и генерирует рабочие конфигурации. Включается автоматически при запросах о service discovery. CX Codex +1 251установок aggregating-crypto-news Скилл aggregating-crypto-news для Claude Code читает RSS CoinDesk, CoinTelegraph, The Block и Decrypt и фильтрует статьи по монете, категории и времени. Запускается по запросам вроде «последние новости Bitcoin за 4 часа». CX Codex +1 238установок forecasting-time-series-data Скилл forecasting-time-series-data для Claude Code прогнозирует будущие значения по историческим временным рядам. Он включается, когда нужно оценить продажи, посещаемость сайта или другие показатели во времени. CX Codex +1 206установок mermaid-flowchart-generator Скилл mermaid-flowchart-generator для автоматической генерации блок-схем и диаграмм на Mermaid. Срабатывает сам, когда в запросе появляется упоминание mermaid. CX Codex +1 174установок vertex-infra-expert Скилл vertex-infra-expert для развёртывания инфраструктуры Vertex AI через Terraform. Создаёт эндпоинты Gemini, индексы векторного поиска, ML-пайплайны и сервисы с шифрованием, автомасштабированием и IAM по принципу наименьших привилегий. CX Codex +1 154установок

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

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