Generate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns. Use when creating API documentation, generating SDKs, or ensuring API contract compliance.
Add this skill
npx mdskills install sickn33/openapi-spec-generationWell-scoped API documentation skill but lacks concrete actionable instructions in main file
1---2name: openapi-spec-generation3description: Generate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns. Use when creating API documentation, generating SDKs, or ensuring API contract compliance.4---56# OpenAPI Spec Generation78Comprehensive patterns for creating, maintaining, and validating OpenAPI 3.1 specifications for RESTful APIs.910## Use this skill when1112- Creating API documentation from scratch13- Generating OpenAPI specs from existing code14- Designing API contracts (design-first approach)15- Validating API implementations against specs16- Generating client SDKs from specs17- Setting up API documentation portals1819## Do not use this skill when2021- The task is unrelated to openapi spec generation22- You need a different domain or tool outside this scope2324## Instructions2526- Clarify goals, constraints, and required inputs.27- Apply relevant best practices and validate outcomes.28- Provide actionable steps and verification.29- If detailed examples are required, open `resources/implementation-playbook.md`.3031## Resources3233- `resources/implementation-playbook.md` for detailed patterns and examples.34
Full transparency — inspect the skill content before installing.