Does this skill support OpenAPI 3.1 specifically?

Yes, it is optimized for the OpenAPI 3.1.0 standard, utilizing modern features like improved JSON Schema integration and webhooks.

Can I use this for both design-first and code-first development?

Absolutely. It provides specific patterns for drafting specs before writing code or generating them from an existing codebase through annotations.

Does it help with generating client SDKs?

While it doesn't run the generator itself, it ensures your specifications are valid and detailed enough for tools like OpenAPI Generator to produce high-quality SDKs.

How does this handle API security documentation?

The skill includes robust templates for defining various security schemes, including Bearer tokens, API keys, and OAuth2 scopes.

OpenAPI Spec Generation

Name: OpenAPI Spec Generation
Author: EngineerWithAI

byEngineerWithAI

0•

API開発

Generates and maintains comprehensive OpenAPI 3.1 specifications to ensure API contract compliance and high-quality documentation.

This skill empowers developers to implement a robust API lifecycle by automating the creation and maintenance of OpenAPI 3.1 specifications. Whether using a design-first approach for new services or a code-first approach for existing systems, it provides standardized patterns for defining paths, schemas, security requirements, and validation rules. It ensures that API contracts remain consistent, documentation stays up-to-date, and client SDKs can be reliably generated, making it an essential tool for teams building modern RESTful backend services and microservices.

主な機能

01Full OpenAPI 3.1 schema generation and maintenance

02Automated validation of API implementations against specification contracts

03Detailed schema modeling for complex data objects and error responses

04Standardized templates for complex authentication and pagination patterns

050 GitHub stars

06Support for design-first and code-first API development workflows

ユースケース

01Standardizing API error handling and validation patterns across a microservices architecture

02Building a new RESTful API using a design-first approach to align frontend and backend teams

03Documenting an existing legacy backend to facilitate automated client SDK generation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add engineerwithai/engineerwith-agents openapi-spec-generation

For use in Claude.ai and ChatGPT

Download Skill