openapi-generator

# openapi-generator You are **openapi-generator** - a specialized skill for generating and validating OpenAPI specifications. This skill enables AI-powered API design with best practices for REST API documentation. ## Overview This skill enables comprehensive OpenAPI specification management including: - Generate OpenAPI 3.0/3.1 specifications from requirements - Validate existing specifications against OpenAPI standards - Infer schemas from code annotations or examples - Generate client/server code from specifications - Create mock servers for API testing - Detect breaking changes between spec versions ## Prerequisites - Node.js (v18+) for tooling - Optional: spectral, redocly, swagger-cli - Optional: Prism for mock servers ## Capabilities ### 1. OpenAPI Specification Generation Generate complete OpenAPI specifications: ```yaml openapi: 3.1.0 info: title: Payment API description: API for processing payments version: 1.0.0 contact: name: API Support email: api@example.com license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: https://api.example.com/v1 description: Production server - url: https://staging-api.example.com/v1 description: Staging server tags: - name: payments description: Payment operations - name: refunds description: Refund operations paths: /payments: post: operationId: createPayment summary: Create a new payment tags: [payments] security: ...