openapi-specs

Generate, validate, and detect drift in OpenAPI specifications from API code.

Updated Feb 3, 2026

Search Tags:#openapi #code generation #validation #drift detection #swagger #api documentation #api specification

Ready to run

npx skills add https://github.com/dhruvinrsoni/agentskills-garden --skill openapi-specs

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: openapi-specs
Source: https://github.com/dhruvinrsoni/agentskills-garden/tree/main/skills/80-docs/openapi-specs
Command: npx skills add https://github.com/dhruvinrsoni/agentskills-garden --skill openapi-specs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the creation and maintenance of OpenAPI (Swagger) specifications for APIs, ensuring documentation stays synchronized with the codebase and adheres to best practices.

Core Features & Use Cases

Code-to-Spec Generation: Automatically generate OpenAPI specs from API code (e.g., Express, FastAPI, Spring).
Spec Validation: Lint and validate existing OpenAPI specs for correctness and completeness.
Drift Detection: Identify discrepancies between the API implementation and its specification.
Use Case: After adding a new endpoint to your FastAPI application, use this Skill to update the openapi.yaml file, ensuring your API documentation accurately reflects the new functionality.

Quick Start

Generate an OpenAPI 3.1 specification from the current API code.

Frequently Asked Questions about openapi-specs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I generate OpenAPI specifications from existing API code?▼

Generate OpenAPI specifications directly from API code by analyzing routing logic in frameworks like Express, FastAPI, Spring, and Go to automatically produce accurate API documentation files.

Can I validate an existing Swagger specification for correctness?▼

Validate existing Swagger and OpenAPI specifications for correctness and completeness by running them through linters like Spectral and swagger-cli to ensure they adhere to best practices.

How do I detect drift between my API implementation and its specification?▼

Detect API drift by comparing your current API code against existing OpenAPI specifications, automatically identifying discrepancies where your documentation is out of synchronization with your implementation.

Does this OpenAPI generation tool support FastAPI and Express frameworks?▼

OpenAPI generation supports multiple frameworks including FastAPI, Express, Spring, and Go, allowing you to automatically create and update specifications directly from your specific API codebase.

What is the best way to keep API documentation synchronized with my codebase?▼

Keep API documentation synchronized with your codebase by generating OpenAPI specs from API code and detecting drift, ensuring documents accurately reflect new endpoints and functionality after implementation changes.