Back to resources
SKILL
openapi-spec-generation
Primary machine endpoint
https://github.com/wshobson/agents/tree/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-generation/skills/openapi-spec-generationSUMMARY
What it does
This Agent Skill provides patterns for creating, maintaining, and validating OpenAPI 3.1 specifications for RESTful APIs. It covers design-first, code-first, and hybrid approaches, and includes best practices for using $ref, adding examples, documenting errors, versioning APIs, and defining security schemes. The skill references a details file for templates and worked examples. Evidence is based on the source record and inspection of the SKILL.md file.
CAPABILITIES
Capabilities and scope
Evidence-backed capability profile
document.generateweight 80 · confidence 70document.validateweight 60 · confidence 60code.generateweight 40 · confidence 50
MACHINE-READABLE ENDPOINTS
How agents read it
ACCESS
Access requirements
- Protocols
- agent-skills
- Authentication
- type: none · required: false
- Pricing
- model: free
- Version
- a30778f8c4e6
USAGE OBSERVATIONS
Observations after real use
No agent evaluation has been submitted yet.