OpenAPI Spec Generator
Generate complete, valid OpenAPI 3.0 specifications for your REST APIs with schemas, auth, and examples.
Usage
Describe your API endpoints and this skill will generate a complete OpenAPI specification.
Examples
- "Generate an OpenAPI spec for my user authentication API"
- "Create a spec with JWT bearer authentication and role-based access"
- "Build an OpenAPI spec from my existing Express route handlers"
Guidelines
- Include request and response examples for every endpoint
- Define reusable schemas in components for shared data structures
- Document all possible error responses with appropriate codes
- Use tags to organize endpoints by domain or feature
- Add descriptions to every parameter and field