Backend
593 installs
openapi-spec-generation
by wshobson/agents
Generate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns. Use when creating API documentation, generating SDKs,…
Skill content
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 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 Core Concepts 1. OpenAPI 3.1 Structure