api-documentation-generator

Generate API documentation with endpoints, schemas, and examples from source code.

Updated Nov 29, 2025
One-click install
npx skills add https://github.com/thimslugga/agent-skills --skill api-documentation-generator-thimslugga
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-documentation-generator
Source: https://github.com/thimslugga/agent-skills/tree/main/skills/documents/api-documentation-generator
Command: npx skills add https://github.com/thimslugga/agent-skills --skill api-documentation-generator-thimslugga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the creation of developer-friendly API documentation directly from source code, ensuring consistency and reducing manual writing effort.

Core Features & Use Cases

  • Automatic extraction of endpoints, HTTP methods, parameters, authentication requirements, and error handling.
  • Generation of request/response schemas, example code snippets, and usage notes for REST, GraphQL, and WebSocket APIs.
  • Use Case: onboarding teams and updating docs for evolving APIs by producing up-to-date OpenAPI/Swagger specifications and reference materials.

Quick Start

Generate up-to-date API documentation from your codebase and export an OpenAPI specification along with example usage.

Frequently Asked Questions about api-documentation-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate API documentation from source code?

Generate API documentation from source code by analyzing REST, GraphQL, and WebSocket APIs to extract endpoint details, request/response schemas, parameters, authentication requirements, and usage guidelines. This produces developer-friendly reference materials and OpenAPI/Swagger specifications automatically.

Can I create an OpenAPI or Swagger specification from my existing codebase?

Create OpenAPI or Swagger specifications from an existing codebase by analyzing API endpoints, HTTP methods, and parameters directly from source code. This generates up-to-date specification files alongside example code snippets and usage notes for evolving APIs.

Does API documentation generation work for GraphQL and WebSocket APIs?

API documentation generation works for GraphQL and WebSocket APIs, as well as REST. It analyzes source code to extract endpoint details, request and response schemas, authentication requirements, and error handling for each protocol type.

What's the best way to keep API docs updated for evolving APIs?

Keep API docs updated for evolving APIs by generating documentation directly from source code. This ensures consistency and reduces manual writing effort by automatically extracting current endpoint details, schemas, and versioning information into OpenAPI specifications.

How does automated code analysis extract API endpoint details?

Automated code analysis extracts API endpoint details by parsing source code to identify HTTP methods, parameters, authentication requirements, and error handling. It generates corresponding request and response schemas, examples, and usage guidelines for developer onboarding.

Do I need existing code annotations to generate API reference materials?

You do not need existing code annotations to generate API reference materials. This skill analyzes the source code structure directly to produce endpoint details, authentication requirements, error handling documentation, and example code snippets automatically.