openapi-spec-generator
SkillDev toolsLets your agent create OpenAPI or Swagger API specification files from plain descriptions, code, or partial specs.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the openapi-spec-generator skill
About this capability
Generates valid, expressive OpenAPI 3.1 specifications from code handlers, route declarations, and data schemas.
What this skill tells your AI
The instructions your AI receives, as published by codebygarv/ai-skills in skills/utilities/openapi-spec-generator/SKILL.md and read by ahel’s review.
Purpose
Extract and synthesize accurate, production-grade OpenAPI 3.1 / Swagger YAML specifications directly from route definitions, request/response models, validation schemas (Zod, Joi, Pydantic), and controller code.
When to Use
- Documenting REST APIs for external developer consumption.
- Generating interactive Swagger UI or Redoc documentation portals.
- Setting up automated SDK generation (via openapi-generator / stainless).
What to Analyze
- Path & Operation Metadata: HTTP Method, summary, description, tags, and
operationId. - Parameters: Path parameters (
{id}), query parameters with types and defaults, and headers. - Request Body Schema: Content types (
application/json), required fields, examples, and nested object types. - Response Status Codes: 200/201 Success payloads, 400 Bad Request validation schemas, 401/403 Auth errors, 404 Not Found.
- Security Schemes: Bearer JWT (
http), API Key (apiKey), or OAuth2 flows.
Output Format
- OpenAPI 3.1.0 YAML: Valid, lint-clean specification document.
- Reusable Component Schemas:
components/schemasto eliminate JSON duplication. - Swagger UI Integration Snippet: Fast setup instructions for documentation rendering.
Avoid
- Omitting error response definitions (400, 401, 404, 500).
- Hand-writing unstructured mock payloads without schema validation rules.
Signals
- GitHub stars
- 25
- Forks
- 1
- Last commit
- Aug 2026
Advanced
- Catalog kind
- skill
- Gateway key
openapi-spec-generator- Source
- github.com/codebygarv/ai-skills