api-docs-generator
Automatically generate OpenAPI specs, GraphQL schemas, and Markdown reference docs from your codebase.
- Generate OpenAPI 3.1 YAML from FastAPI, Express, or Flask apps
- Create Markdown reference pages for library exports and function signatures
- Enhance GraphQL schemas with descriptive docstrings inferred from resolvers
$12
One-time purchase
Included in download
- Generate OpenAPI 3.1 YAML from FastAPI, Express, or Flask apps
- Create Markdown reference pages for library exports and function signatures
- file_read, file_write automation included
- Includes example output and usage patterns
See it in action
paths:
/users/{id}:
get:
summary: Get user profile
parameters:
- name: id
in: path
required: true
schema: {type: integer}
responses:
'200':
description: OK
content:
application/json:
schema: {$ref: '#/components/schemas/User'}api-docs-generator
Automatically generate OpenAPI specs, GraphQL schemas, and Markdown reference docs from your codebase.
$12
One-time purchase
⚡ Also available via Agensi MCP — your AI agent can load this skill on demand via MCP. Learn more →
Included in download
- Generate OpenAPI 3.1 YAML from FastAPI, Express, or Flask apps
- Create Markdown reference pages for library exports and function signatures
- file_read, file_write automation included
- Includes example output and usage patterns
- Instant install
See it in action
paths:
/users/{id}:
get:
summary: Get user profile
parameters:
- name: id
in: path
required: true
schema: {type: integer}
responses:
'200':
description: OK
content:
application/json:
schema: {$ref: '#/components/schemas/User'}About This Skill
Automated API Specification and Reference Generation
Keep your documentation in sync with your source code without the manual overhead. This skill analyzes your project's routing, schema definitions, and type annotations to generate high-quality API documentation across various formats including OpenAPI 3.1, Markdown, and GraphQL SDL.
Framework and Language Agnostic
Whether you are building REST APIs with FastAPI, Express, or Spring, or developing internal libraries in TypeScript or Python, this skill identifies your stack automatically. It traverses your codebase to extract path parameters, request/response schemas, authentication guards, and function signatures.
Why use this skill?
- Eliminate Drift: Generates docs directly from code, ensuring your OpenAPI spec matches your actual implementation.
- Rich Type Extraction: Deeply integrates with validation libraries like Zod, Pydantic, and Joi to produce accurate schemas.
- Intelligent Summarization: Uses existing docstrings and code context to write meaningful descriptions for endpoints and parameters.
- Development Speed: Instantly creates `API.md` files for libraries or `openapi.yaml` for services, ready for tools like Swagger UI or Redoc.
Professional Output
The output is structured, valid, and follows industry standards. It includes status codes, error types, and even usage examples pulled from your existing test suites or inferred from type shapes.
Use Cases
- Generate OpenAPI 3.1 YAML from FastAPI, Express, or Flask apps
- Create Markdown reference pages for library exports and function signatures
- Enhance GraphQL schemas with descriptive docstrings inferred from resolvers
- Extract API schemas from validation logic like Zod, Pydantic, or Joi
- Produce structured error response documentation from middleware and decorators
How to Install
mkdir -p ~/.claude/skills && curl -sL https://www.agensi.io/api/install/api-docs-generator | tar xz -C ~/.claude/skills/Free skills install directly. Paid skills require purchase - use the download button above after buying.
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
Reads source code and writes API documentation as a new file (openapi.yaml, API.md, or alongside GraphQL schema). Does not call your API or validate examples against a running server.
Creator
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.
code-reviewer
Reviews your code for bugs, security vulnerabilities, logic errors, performance issues, and style violations. Organizes findings by severity and suggests fixes with code examples.