openapi-spec-generation
A skill from the documentation-generation plugin in wshobson's agents collection for writing, maintaining and checking OpenAPI 3.1 specifications for REST APIs.
Differs from the main skill, openapi-spec-generation (13% the same text). May be an adapted copy or an older version.
What the skill teaches
A skill from the documentation-generation plugin in wshobson's agents collection for writing, maintaining and checking OpenAPI 3.1 specifications for REST APIs. It outlines the main parts of a specification, from info and servers to paths, shared schemas and security schemes, and compares three ways of working: writing the specification before the code, generating it from existing code, or annotating code and generating from the annotations. A short list of practices asks for reusable components, realistic examples, every error code documented, versioning, explicit nullability, consistent naming and server variables instead of fixed URLs. Templates and worked examples sit in a separate reference file. It names no particular generator or validator.
Capabilities
- Write an OpenAPI 3.1 specification
- Choose design-first or code-first working
- Define reusable schemas and security schemes
About
- Publisher
- wshobson
- Tool
- Documentation
Install
The project doesn't document install steps that we could confirm. See the project's own instructions
What's inside
- references/code-first-and-tooling.md
- references/details.md
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Documentation | |
| Publisher | wshobson | source |
| Official status | Not stated in its documentation | |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | No | source |
| Platforms | Not stated in its documentation | |
| AI clients | Not stated in its documentation | |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 9, 202642,406 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
More from wshobson
3 skills
All 3 from wshobson →Also listed under: Documentation
Sources
- Skill file (SKILL.md)github.com/wshobson/agents · Backs: Includes scriptsNov 10, 2026
- GitHub repositorygithub.com/wshobson/agents · Backs: Licence, Publisher, ActivityNov 11, 2026
- Skill file (SKILL.md)github.com/sickn33/agentic-awesome-skillsNov 17, 2026
- Folder in the repository (openapi-spec-generation)github.com/wshobson/agents · Backs: Includes scriptsNov 10, 2026