openapi-swagger
Expert skill for OpenAPI/Swagger specification analysis, validation, and documentation generation. Parse and validate specs, detect breaking changes, generate code samples, and lint for best practices.
npx skills add a5c-ai/babysitter --skill openapi-swagger --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/Swagger Skill Expert skill for OpenAPI/Swagger specification analysis and documentation generation. ## Capabilities - Parse and validate OpenAPI 3.x and Swagger 2.0 specifications - Generate API documentation from specs (ReDoc, Swagger UI) - Detect breaking changes between API versions - Validate request/response examples against schemas - Generate code samples in multiple languages - Lint OpenAPI specs for best practices (Spectral rules) - Convert between OpenAPI formats (YAML/JSON, version migration) ## Usage Invoke this skill when you need to: - Validate and lint OpenAPI specifications - Generate API reference documentation - Detect breaking changes between API versions - Create code samples from API specs - Migrate between OpenAPI versions ## Inputs | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | specPath | string | Yes | Path to OpenAPI/Swagger spec file | | action | string | Yes | validate, lint, generate-docs, diff, generate-samples | | outputDir | string | No | Output directory for generated content | | targetVersion | string | No | Target OpenAPI version for migration | | languages | array | No | Languages for code sa
- Capabilities
- Usage
- Inputs
- Input Example
- Output Structure
- Validation Output
- Breaking Changes Output
- OpenAPI Specification Patterns
- OpenAPI 3.1 Template
- Spectral Configuration
- .spectral.yaml
- Code Sample Generation
- Generated Samples
- Workflow
cURL curl -X GET 'https://api.example.com/v1/users' \ Validate spec npx @redocly/cli lint openapi.yaml Spectral linting npx spectral lint openapi.yaml Generate ReDoc documentation npx @redocly/cli build-docs openapi.yaml -o docs/index.html Detect breaking changes oasdiff breaking old-api.yaml new-api.yaml
What does the openapi-swagger skill do?
Expert skill for OpenAPI/Swagger specification analysis, validation, and documentation generation. Parse and validate specs, detect breaking changes, generate code samples, and lint for best practices.
How do I install it?
Run `npx skills add a5c-ai/babysitter --skill openapi-swagger --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.