openapi-spec-generator
Automated OpenAPI specification generation from code annotations, comments, and interface definitions
npx skills add a5c-ai/babysitter --skill openapi-spec-generator --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# OpenAPI Spec Generator Skill ## Overview This skill automates the generation of OpenAPI 3.x specifications from code annotations, comments, and interface definitions. It parses source code to extract API endpoints, schemas, and documentation to produce comprehensive and accurate API specifications. ## Capabilities - Parse code to extract API endpoints and schemas from annotations - Generate OpenAPI 3.x specifications in YAML or JSON format - Validate spec completeness and correctness against OpenAPI standards - Auto-update specs from code changes with incremental generation - Support multiple frameworks (Express, FastAPI, Spring, ASP.NET, etc.) - Extract request/response schemas from TypeScript types, Python type hints, Go structs - Generate examples from code-level documentation ## Target Processes - API Design Specification - API Documentation System - SDK Code Generation Pipeline ## Integration Points - Code analysis tools (AST parsers) - Schema validators (Spectral, openapi-spec-validator) - Swagger/OpenAPI tooling ecosystem - IDE extensions for spec preview ## Input Requirements - Source code with API route definitions - Annotation/decorator conventions used in the codebase
- Overview
- Capabilities
- Target Processes
- Integration Points
- Input Requirements
- Output Artifacts
- Usage Example
- Best Practices
What does the openapi-spec-generator skill do?
Automated OpenAPI specification generation from code annotations, comments, and interface definitions
How do I install it?
Run `npx skills add a5c-ai/babysitter --skill openapi-spec-generator --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From a5c-ai/babysitter, a repository with 1,642 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.