openapi-spec-generation
Installation
Summary
Generate, maintain, and validate OpenAPI 3.1 specifications for RESTful APIs.
- Supports design-first, code-first, and hybrid approaches with templates for complete specs, FastAPI/Python generation, and TypeScript/Express decorators
- Includes reusable components for schemas, parameters, responses, and security schemes to minimize duplication across endpoints
- Provides Spectral and Redocly validation rules to enforce naming conventions, security requirements, and documentation standards
- Enables SDK generation for TypeScript, Python, Go, and other languages via OpenAPI Generator with customizable output options
SKILL.md
OpenAPI Spec Generation
Comprehensive patterns for creating, maintaining, and validating OpenAPI 3.1 specifications for RESTful APIs.
When to Use This Skill
- Creating API documentation from scratch
- Generating OpenAPI specs from existing code
- Designing API contracts (design-first approach)
- Validating API implementations against specs
- Generating client SDKs from specs
- Setting up API documentation portals