Can I use this for existing code bases?

Absolutely. It supports code-first and hybrid approaches to help you document and generate specifications from your existing API implementations.

Does it include templates for security and authentication?

Yes, the skill provides reusable components for security schemes, including Bearer tokens, API keys, and standard OAuth2 patterns.

Does this skill support the latest OpenAPI standards?

Yes, it is specifically designed for OpenAPI 3.1, supporting modern features such as webhooks and enhanced JSON schema compatibility.

How does this help with SDK generation?

By producing valid, high-quality OpenAPI files with correct operationIds and schemas, it ensures compatibility with popular SDK generators like OpenAPI Generator and Speakeasy.

OpenAPI Spec Generator

Name: OpenAPI Spec Generator
Author: drgaciw

bydrgaciw

0•

API Development

Streamlines the creation and maintenance of OpenAPI 3.1 specifications to ensure API contract compliance and high-quality documentation.

This skill empowers developers to build and maintain comprehensive OpenAPI 3.1 specifications for RESTful APIs. Whether using a design-first approach for new contracts or a code-first approach for existing services, it provides standardized patterns for defining paths, schemas, security schemes, and validation rules. It is particularly useful for teams looking to automate documentation generation, ensure API consistency, or generate reliable client SDKs and automated testing suites.

Key Features

010 GitHub stars

02Standardized templates for design-first and code-first development

03Built-in patterns for complex request/response schema validation

04Support for multi-server configurations and environment-specific documentation

05Full support for OpenAPI 3.1 standards and YAML structures

06Reusable component definitions for pagination, errors, and security

Use Cases

01Designing new API contracts before implementation to align stakeholders

02Validating API implementations against specifications to prevent contract drift

03Documenting existing legacy APIs for external developer consumption

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add drgaciw/academic-compliance-hub-glm openapi-spec-generation

For use in Claude.ai and ChatGPT

Download Skill