| name | openapi-generator |
| description | Generate OpenAPI specifications from code or legacy APIs with schema inference and documentation |
| allowed-tools | ["Bash","Read","Write","Grep","Glob","Edit"] |
| graph | {"domains":["domain:software-engineering"],"specializations":["specialization:code-migration-modernization"],"skillAreas":["skill-area:api-doc-generation","skill-area:api-design"],"roles":["role:backend-engineer","role:technical-writer"],"workflows":["workflow:technical-debt-reduction"],"topics":["topic:refactoring"]} |
OpenAPI Generator Skill
Generates OpenAPI specifications from code annotations, legacy APIs, or runtime analysis, with schema inference and documentation generation.
Purpose
Enable API documentation for:
- Spec generation from code
- Schema inference
- Example generation
- Validation rule extraction
- Documentation generation
Capabilities
1. Spec Generation from Code Annotations
- Parse JSDoc/Swagger annotations
- Extract from decorators
- Process code comments
- Support multiple languages
2. Schema Inference
- Infer from TypeScript types
- Extract from runtime samples
- Build from database models
- Derive from existing payloads
3. Example Generation
- Generate realistic examples
- Create edge case samples
