create-api-spec

What problem does it solve?

This Skill eliminates the tedious, error-prone manual work of writing API specification documents from scratch when you already have the endpoint source code, saving development teams hours of repetitive documentation effort.

Core Features & Use Cases

• Framework-Agnostic Support: Works with any major backend framework including .NET, Node.js, Python, Java, and Go, automatically adapting extraction logic to match each framework's routing and annotation patterns.
• Automated Metadata Extraction: Pulls all 8 critical pieces of API information (HTTP method, full URL, auth requirements, path/query/body parameters, success/error responses, example payloads) directly from endpoint source code with no manual lookup required.
• Standardized Spec Output: Generates consistently formatted Markdown spec files with correct file:// source code links, unified error envelope formatting, and kebab-case file naming, ready to integrate into your project documentation.
• Use Case Example: For a .NET Minimal API endpoint like GetTodoByIdEndpoint.cs, this Skill automatically produces a full spec doc with all request parameters, response schemas, error codes, and linked source references in seconds.

Quick Start

Use the create-api-spec skill to generate a complete API specification document for the endpoint located at src/TodoAPI/Modules/Todo/GetTodoById/GetTodoByIdEndpoint.cs.