API Documentation Generator

Overview

Generate comprehensive, structured API documentation by analyzing source code. The skill extracts endpoint definitions, HTTP methods, parameters, request/response schemas, authentication requirements, and error handling patterns, then produces documentation in both human-readable Markdown and machine-readable OpenAPI 3.0 JSON format.

When to use

• The task is documenting an existing API from source code, route definitions, handlers, or schemas.
• The deliverable is reference documentation, endpoint docs, or an OpenAPI-style spec.
• The user needs to capture current API behavior, inputs, outputs, auth, and error shapes.
• The code already exists; the problem is documentation quality or completeness.

Do NOT use when: