swagger-gen

What problem does it solve?

This Skill automatically generates OpenAPI 3.0 specifications from your Express route definitions, ensuring up-to-date API documentation with minimal manual effort.

Core Features & Use Cases

• Auto API documentation: Converts route definitions into a complete OpenAPI spec with endpoints, methods, and schemas.
• Zero-config integration: Works with existing Express route files without heavy setup.
• Use Case: When you add or modify routes, regenerate api.yaml and feed Swagger UI or API clients with accurate docs.

Quick Start

Generate the OpenAPI spec from your routes:

• From a directory: npx ai-swagger ./src/routes/
• From a single file: npx ai-swagger ./src/routes/users.ts -o docs/api.yaml