api-docs-gen
by Kevin Cline
Convert source code into OpenAPI 3.0 specs or Markdown docs via static analysis of Express, FastAPI, and more.
- Generate OpenAPI 3.0 specs for Swagger UI integration
- Create clean API Markdown documentation for GitHub READMEs
- Audit route security by mapping auth middleware across all endpoints
$10
One-time purchase · Own forever
Included in download
- Generate OpenAPI 3.0 specs for Swagger UI integration
- Create clean API Markdown documentation for GitHub READMEs
- Includes example output and usage patterns
See it in action
paths:
/users/{id}:
get:
summary: Get user by ID
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/User'api-docs-gen
by Kevin Cline
Convert source code into OpenAPI 3.0 specs or Markdown docs via static analysis of Express, FastAPI, and more.
$10
One-time purchase · Own forever
⚡ Also available via Agensi Pro — your AI agent can load this skill on demand via MCP. Learn more →
Included in download
- Generate OpenAPI 3.0 specs for Swagger UI integration
- Create clean API Markdown documentation for GitHub READMEs
- Includes example output and usage patterns
- Instant install
- One-time purchase
See it in action
paths:
/users/{id}:
get:
summary: Get user by ID
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/User'About This Skill
Automated API Documentation from Source Code
Ditch the manual Swagger updates. This skill performs deep static analysis on your backend source code to generate professional-grade API documentation instantly. It maps routes, methods, schemas, and authentication requirements without requiring any manual entry or API keys.
What it does
- Multi-Framework Discovery: Supports Node.js (Express, Next.js, Hono, Koa), Python (FastAPI, Flask, Django REST), and more.
- Deep Schema Extraction: Infers request/response shapes from TypeScript interfaces, Zod schemas, Pydantic models, and JSDoc comments.
- Auth Mapping: Automatically identifies protected routes by detecting middleware like JWT, Passport, or FastAPI Dependencies.
- Dual Output Formats: Exports to valid OpenAPI 3.0 YAML for tooling or clean Markdown for READMEs and internal wikis.
Why use this skill?
Writing documentation is tedious and prone to drifting from reality. Unlike generic prompts, this skill uses specific heuristics to scan your file system, understand framework-specific routing patterns, and infer types from variable naming conventions when explicit types are missing. It produces structured, deployment-ready documentation that follows industry standards.
Supported Industry Tools
- Specifications: OpenAPI 3.0.3 (Swagger)
- Documentation: GitHub-flavored Markdown
- Validation: Compatible with Swagger UI, Redoc, and Postman
Use Cases
- Generate OpenAPI 3.0 specs for Swagger UI integration
- Create clean API Markdown documentation for GitHub READMEs
- Audit route security by mapping auth middleware across all endpoints
- Synchronize documentation with code changes in CI/CD pipelines
How to Install
unzip api-docs-gen.zip -d ~/.claude/skills/Reviews
No reviews yet — be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
Early access skill
Be the first to review this skill.
Only users who have downloaded or purchased this skill can leave a review.
Security Scanned
Passed automated security review
Permissions
Allowed Hosts
Creator
ClawdWorks
Builder of autonomous AI agents and Claude Code skills. ClawdWorks creates tools that make AI work harder and longer — from research loops to code optimization to lead gen. Powered by Claude Opus 4.6 + Codex 5.4.
Frequently Asked Questions
Learn More About AI Agent Skills
Similar Skills
readme-generator
Generates a complete, polished README.md by scanning your actual project structure, dependencies, and code.
pr-description-writer
Writes clear pull request descriptions by analyzing your branch diff. Covers what changed, why, how, and what to test. Works with GitHub, GitLab, and Bitbucket.
changelog-generator
Generates user-facing changelogs from git history. Transforms developer commit messages into clear release notes that users actually understand.
skill-polisher
Transform raw skill documentation into high-conversion, readable marketplace listings without losing LLM context.