extract-openapi-from-code

SKILL.md

Extract an OpenAPI specification from an existing API codebase. Covers eight major frameworks across Python, Java, JavaScript/TypeScript, Ruby, and PHP.

| Framework | Yes | The API framework in use (see Decision Framework) | | Project path | Yes | Root directory of the API project | | Output path | No | Where to write the spec (default: openapi.json or openapi.yaml) | | Target language | No | SDK target language, if generating an SDK after extraction |

| OpenAPI spec | A JSON or YAML file describing the API | | Validation report | Lint results from speakeasy lint |

Use when extracting or generating an OpenAPI spec from existing API code. Triggers on "extract OpenAPI", "code first", "generate spec from code", "FastAPI OpenAPI", "Spring Boot OpenAPI", "NestJS swagger", "Django OpenAPI", "Flask OpenAPI", "Rails swagger", "Laravel OpenAPI", "existing API code" Source: speakeasy-api/agent-skills.

View raw