swagger-doc-creator — Claude Code skill: what it does, how to install
swagger-doc-creator automates Swagger and OpenAPI documentation tasks, generating schema configurations and validating API definitions against standard patterns.
MIT 239 installs ★ 2,935 updated 2026-11-01
npx skills add jeremylongshore/tons-of-skills-marketplace --skill swagger-doc-creator -a claude-codeWhat swagger-doc-creator does
This skill guides API documentation workflows within your editor. It prepares schema configurations, writes output files, and checks the generated endpoints against standard API design rules.
The skill relies on specific agent tools: file operations via Read, Write, and Edit, pattern searches with Grep, and restricted shell execution using Bash(curl:*). External terminal calls are strictly limited to curl requests.
Missing parameters cause configuration validation failures. You must have your target development environment and required dependencies ready beforehand.
What it helps with
- generate Swagger and OpenAPI configurations for existing routes
- validate schema parameters against standard API specifications
- structure endpoint documentation and design patterns
Example prompts for the agent
- Help me with swagger doc creator for this backend
- Generate Swagger documentation for the authentication endpoints
- Check our OpenAPI schema configuration for missing fields
How to install swagger-doc-creator
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill swagger-doc-creator -a claude-code2Manually: put the files in place
~/.claude/skills/swagger-doc-creator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/swagger-doc-creator/
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill swagger-doc-creator -a codex2Manually: put the files in place
.agents/skills/swagger-doc-creator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill swagger-doc-creator -a cursor2Manually: put the files in place
.cursor/skills/swagger-doc-creator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jeremylongshore/tons-of-skills-marketplace skills/15-api-development/swagger-doc-creator2Manually: put the files in place
.github/skills/swagger-doc-creator/SKILL.md1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill swagger-doc-creator -a gemini-cli2Platform CLI
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/15-api-development/swagger-doc-creatorManually: put the files in place
.devin/skills/swagger-doc-creator/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill swagger-doc-creator -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about swagger-doc-creator
How do I install swagger-doc-creator in Claude Code?
Run npx skills add jeremylongshore/tons-of-skills-marketplace --skill swagger-doc-creator -a claude-code. The skill specification will be placed in ~/.claude/skills/swagger-doc-creator/SKILL.md.
What does swagger-doc-creator do?
It provides step-by-step guidance for Swagger documentation, produces ready-to-use API configurations, and validates schema output.
Which tools does swagger-doc-creator access?
It uses Read, Write, and Edit for file manipulation, Grep for searching code, and Bash(curl:*) for network requests.
Source text
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