This generates complete OpenAPI 3.1 specs from scratch or existing code, handling the tedious parts like parameter definitions, response schemas, and component references. You'd use it when documenting APIs, setting up contract-first development, or generating client SDKs. It covers the full spec structure including authentication schemes, error responses, and validation rules. The templates are comprehensive enough that you can copy-paste and modify rather than writing boilerplate YAML from memory. It's solid for both greenfield API design and retrofitting documentation onto existing endpoints.
npx skills add https://github.com/wshobson/agents --skill openapi-spec-generation