openapi-generator
Specialized skill for generating and validating OpenAPI 3.0/3.1 specifications. Supports code-first and spec-first approaches, schema inference, validation, and mock server generation.
npx skills add a5c-ai/babysitter --skill openapi-generator --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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: - n
- Overview
- Prerequisites
- Capabilities
- 1. OpenAPI Specification Generation
- 2. Specification Validation
- 3. Schema Inference
- 4. Breaking Change Detection
- 5. Mock Server Generation
- 6. Code Generation
- MCP Server Integration
- Best Practices
- API Design Principles
- Schema Design
- Security Definitions
Using Spectral (Stoplight) spectral lint openapi.yaml --ruleset .spectral.yaml Using Redocly CLI redocly lint openapi.yaml Using swagger-cli swagger-cli validate openapi.yaml Using openapi-generator-cli openapi-generator-cli validate -i openapi.yaml Using openapi-diff openapi-diff v1/openapi.yaml v2/openapi.yaml --format json
What does the openapi-generator skill do?
Specialized skill for generating and validating OpenAPI 3.0/3.1 specifications. Supports code-first and spec-first approaches, schema inference, validation, and mock server generation.
How do I install it?
Run `npx skills add a5c-ai/babysitter --skill openapi-generator --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From a5c-ai/babysitter, a repository with 1,642 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.