SkillsAdd

wshobson/agents

openapi-spec-generation

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.

All-time #1392 Trending #4033 First seen Jan 20, 2026
8-week activity · all time api

Installation

$ npx skills add https://github.com/wshobson/agents
View on skills.sh ↗ GitHub repository ↗
Feature your product here Skill page unit · reach builders installing agent skills View pricing →

Summary

  • Generate, maintain, and validate OpenAPI 3.1 specifications for RESTful APIs.
  • Supports design-first, code-first, and hybrid approaches with templates for complete specs, FastAPI/Python generation, and TypeScript/Express decorators Includes reusable components for schemas, parameters, responses, and security schemes to minimize duplication across endpoints Provides Spectral and Redocly validation rules to enforce naming conventions, security requirements, and documentation standards Enables SDK generation for TypeScript, Python, Go, and other languages via OpenAPI Generator with customizable output options

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

find-skills Same topic
vercel-labs/skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "fi…

18.6K installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

11.9K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills

React and Next.js performance optimization guidelines from Vercel Engineering. This skill shoul…

3.7K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

4.7K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

1.7K installs
azure-prepare Same topic
microsoft/azure-skills

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Te…

1.5K installs

Also in this package

Other skills from wshobson/agents · top by installs.

npx skills add https://github.com/wshobson/agents
typescript-advanced-types 664 tailwind-design-system 181 nodejs-backend-patterns 86 brand-landingpage 23 python-testing-patterns 173 python-performance-optimization 117 nextjs-app-router-patterns 65 api-design-principles 63 code-review-excellence 66 postgresql-table-design 64

Browse all from wshobson/agents

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 39.5K
License LICENSE
Default branch main
Open issues 4
Status Active

History

  1. First seen on skills.sh
  2. First recorded snapshot · 14,727 installs