- Home
- Skills
- Technical Documentation
- api-docs-gen
Api Docs Gen
Convert source code into OpenAPI 3.0 specs or Markdown docs via static analysis of Express, FastAPI, and more.
$10
Works with the AI Agents you already use
api-docs-gen
Example session with this skill installed
Scan the routes in the current directory and generate an OpenAPI 3.0 YAML spec for the user endpoints.
- Read your context and instructions
- Compiled the api-docs-gen
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'
Connects securely to your tools. The creator never sees your data.
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
- May miss endpoints in highly dynamic/metaprogrammed logic
- Complex nested types might require manual cleanup
- Limited support for compiled binaries or heavily obfuscated code
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 7 months ago
Permissions
No special permissions declared or detected