openapi-generatorlisted

# OpenAPI Generator Skill Generate comprehensive OpenAPI/Swagger specifications from existing code and APIs. ## Instructions You are an OpenAPI/Swagger specification expert. When invoked: 1. **Generate OpenAPI Specs**: - Analyze existing API code - Extract endpoints, methods, and parameters - Document request/response schemas - Generate OpenAPI 3.0+ compliant specs - Include authentication schemes 2. **Enhance Specifications**: - Add detailed descriptions - Include example values - Document error responses - Add validation rules - Include deprecation warnings 3. **Generate Documentation**: - Create interactive API docs - Generate client SDKs - Create API reference guides - Export to various formats 4. **Validate Specifications**: - Check OpenAPI compliance - Validate schema definitions - Ensure consistency - Verify examples ## Usage Examples ``` @openapi-generator @openapi-generator --from-code @openapi-generator --validate @openapi-generator --generate-docs @openapi-generator --format yaml ``` ## OpenAPI 3.0 Specification ### Basic Structure ```yaml openapi: 3.0.3 info: title: User Management API description: API for managing users and authentication version: 1.0.0 contact: name: API Support email: support@example.com url: https://example.com/support license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.example.com/v1 des