How does this skill help with API validation?

It uses the Spectral CLI to lint your generated YAML files, identifying missing operationIds, lack of examples, or incomplete descriptions before you deploy.

Do I need existing contracts to use this skill?

While it is optimized to convert 'api-contracts.md' files created during the planning phase, it can also be used to draft new specifications from scratch using its templates.

What version of OpenAPI does this skill support?

This skill specifically targets OpenAPI 3.1, allowing you to use the latest features for API documentation and schema definitions.

Can I generate frontend client libraries automatically?

Yes, the skill includes built-in patterns for generating TypeScript fetch clients and Python SDKs using OpenAPI Generator and Orval.

OpenAPI Spec Generation

Name: OpenAPI Spec Generation
Author: Ankurjain1121

byAnkurjain1121

0•

API Development

Converts API contracts into OpenAPI 3.1 specifications and automates the generation of multi-language SDK clients.

This skill streamlines the API design-first workflow by transforming markdown-based API contracts into valid, production-grade OpenAPI 3.1 specifications. It enables developers to bridge the gap between initial design and implementation by providing structured templates, automated validation via Spectral linting, and integrated commands for generating TypeScript and Python SDKs. By maintaining a single source of truth for API definitions, it ensures consistency across documentation, frontend clients, and backend services.

Key Features

01Standardizes security schemes and error response schemas

02Transforms markdown API contracts to OpenAPI 3.1 YAML

03Generates typed SDKs for TypeScript and Python

040 GitHub stars

05Automates spec validation and linting using Spectral

06Supports Orval integration for advanced TypeScript client generation

Use Cases

01Generating type-safe client libraries for frontend and mobile development

02Ensuring API compliance and consistency through automated linting

03Converting design-phase API contracts into interactive documentation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ankurjain1121/dev-workflow-skills openapi-spec-generation

For use in Claude.ai and ChatGPT

Download Skill