What versions of OpenAPI does this skill support?

It generates strictly compliant OpenAPI 3.0.x or 3.1.x specifications in YAML or JSON format.

How do I use the generated YAML with Claude?

Once generated, you can point an OpenAPI MCP server to the YAML file and configure it in your Claude Desktop mcp.json file.

What parts of my code are analyzed?

The skill examines route definitions, controllers, request parsing logic, data models (DTOs), and database schemas to ensure comprehensive coverage.

Does it include examples in the generated documentation?

Yes, it mandates realistic examples for both successful (200, 201) and error (400, 404, 500) responses to help AI agents format requests correctly.

Can this skill help with MCP integration?

Yes, it is specifically designed to produce specs that work perfectly with the official OpenAPI MCP Server, exposing your API as native tool calls.

OpenAPI Specification Generator

Name: OpenAPI Specification Generator
Author: tymoj

bytymoj

0•

Desarrollo de API

Generates comprehensive OpenAPI 3.0 specifications from source code to enable seamless MCP server integration and API documentation.

This skill automates the creation of high-quality, compliant OpenAPI (Swagger) documentation by analyzing your codebase's route definitions, controllers, and data models. It ensures all endpoints include descriptive metadata, strict parameter types, and realistic response examples, making your API instantly compatible with OpenAPI Model Context Protocol (MCP) servers for AI-driven interaction. It simplifies the transition from raw code to a fully documented, machine-readable API interface.

Características Principales

010 GitHub stars

02Direct compatibility with OpenAPI MCP servers

03Comprehensive data model and DTO extraction

04Strict OpenAPI 3.0/3.1 YAML/JSON compliance

05Automatic route and controller analysis

06Mandatory realistic request and response examples

Casos de Uso

01Preparing internal APIs for use with AI agents and MCP tools

02Converting existing legacy codebases into documented APIs

03Standardizing documentation across microservices and team projects

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tymoj/marketplace generate-openapi

For use in Claude.ai and ChatGPT

Download Skill