api-documentation-generator

OpenAPI documentation generation automatically extracts HTTP methods, paths, parameters, and responses from your route definitions across frameworks like Express, FastAPI, Flask, NestJS, and Rails, then outputs a structured openapi.yaml or swagger.json file.

Route analysis works across Express, FastAPI, Flask, NestJS, Rails, and similar frameworks. The Skill scans your codebase for route definitions, extracts endpoint patterns, and maps them to OpenAPI 3.0 paths with proper HTTP methods and schemas.

Yes. By scanning route files directly, this approach generates documentation from live route definitions rather than manual specs, so your OpenAPI docs stay current as endpoints change without requiring separate updates.

The Skill analyzes route patterns to identify path parameters, query strings, and request bodies, then generates JSON Schema definitions from code models and integrates security schemes and authentication requirements into the OpenAPI output.

Yes. The documentation generation includes mapping of security schemes and authentication requirements extracted from your routes, embedding them into the OpenAPI specification for complete endpoint documentation.

The Skill outputs validated OpenAPI 3.0 specifications as openapi.yaml or swagger.json files placed in your project root, with example content and standardized formatting using template-based generation.