Generates OpenAPI specs and Markdown docs from your API route handlers.
API Doc Generator reads your API route handlers — Express, FastAPI, Next.js API routes, or raw HTTP handlers — and generates both an OpenAPI 3.1 spec and human-readable Markdown documentation.
The skill parses your route files to extract endpoints, HTTP methods, request/response schemas (from TypeScript types, Zod schemas, or Pydantic models), path parameters, query parameters, and authentication requirements. It generates accurate request/response examples based on the detected types.
Output includes a `openapi.yaml` spec file and a `API.md` documentation file with per-endpoint sections including method, path, parameters, request body, response shape, and curl examples. Requires no external services — the skill reads source files and writes documentation files locally.