openapi-spec-generation
Generate, maintain, and validate OpenAPI 3.1 specifications for RESTful APIs.
What it does
- 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
- url: https://api.example.com/v1
Requirements & configuration
- Full template library and detailed worked examples live in references/details.md. Read that file when you need the concrete templates.
Derived from the skill's own SKILL.md documentation · extracted 2026-07-23
Generate, maintain, and validate OpenAPI 3.1 specifications for RESTful APIs.
Source
Repository: https://github.com/wshobson/agents
openapi-spec-generation FAQ
What does the openapi-spec-generation skill do?
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. Creating API documentation from scratch Generating OpenAPI specs from existing code
What does openapi-spec-generation require?
Full template library and detailed worked examples live in references/details.md. Read that file when you need the concrete templates.
How do I install openapi-spec-generation?
Run: npx -y skills add https://github.com/wshobson/agents --skill openapi-spec-generation --agent claude-code — the source lives at github.com/wshobson/agents.
Maintain openapi-spec-generation?
Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.
[](https://getagentictools.com/skills/wshobson-agents-openapi-spec-generation?ref=badge) npx agentictools info skills/wshobson-agents-openapi-spec-generation The second line is the CLI lookup for this page — handy in READMEs and docs.
Related skills
stripe-integration Stripe payment processing with checkout sessions, subscriptions, webhooks, and customer management.
videoagent-video-studio Generate short AI videos from text or images using 7 backend models with zero API key setup.
microservices-patterns Comprehensive guide to designing distributed systems with service boundaries, communication patterns, and resilience strategies.
flutter-handling-http-and-json HTTP requests and JSON serialization for Flutter REST API integration and data parsing.
insforge-cli Backend infrastructure management for InsForge projects via command-line interface.
dotnet-backend-patterns Production-grade C#/.NET patterns for APIs, MCP servers, and enterprise backends with modern async, DI, and data access practices.