api-spec

What problem does it solve?

This Skill streamlines the creation of API documentation by interactively generating specifications in Markdown, OpenAPI (YAML), and GraphQL schema formats.

Core Features & Use Cases

• Multi-Format Output: Supports human-readable Markdown, machine-readable OpenAPI 3.1, and GraphQL SDL.
• Interactive Generation: Guides users through a series of questions to gather necessary API details.
• Use Case: You need to document a new REST API. Use this Skill to generate a comprehensive Markdown document for developers, an OpenAPI spec for integration tools, and a GraphQL schema if needed, all from a single interactive session.

Quick Start

Use the api-spec skill to generate an OpenAPI specification for a new user management API.