openapi-spec-generation

You can generate an OpenAPI 3.1 specification from an existing codebase using a code-first approach. This skill analyzes your REST API code to document endpoints, request/response schemas, and security schemes automatically for your development team and consumers.

Validating API contract compliance involves checking your API implementations against defined OpenAPI specifications. This skill integrates with validation tools like Spectral and Redocly to lint specs and ensure your implementation matches the documented contract.

Yes, you can create a design-first OpenAPI 3.1 specification for a new REST API from scratch. This approach allows you to define endpoints, schemas, and security schemes before writing any implementation code, streamlining subsequent SDK generation.

OpenAPI Generator automates client SDK creation from your OpenAPI specifications. This skill leverages it to produce SDKs in various programming languages, ensuring your consumers have accurate, up-to-date client libraries matching your API documentation.

No external dependencies are required to use this skill for API documentation. It operates independently to generate and maintain OpenAPI 3.1 specifications, though integrating with tools like Spectral, Redocly, or OpenAPI Generator is supported for advanced workflows.

Yes, this skill supports both design-first and code-first API specification approaches. You can either generate a complete OpenAPI 3.1 spec from scratch before development or extract documentation directly from an existing RESTful codebase.