write-api-docs

Generate API reference documentation from code, OpenAPI specs, and endpoint implementations.

Updated Apr 1, 2026
One-click install
npx skills add https://github.com/hpsgd/claude-marketplace --skill write-api-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-api-docs
Source: https://github.com/hpsgd/claude-marketplace/tree/main/plugins/product/developer-docs-writer/skills/write-api-docs
Command: npx skills add https://github.com/hpsgd/claude-marketplace --skill write-api-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates accurate, maintainable API reference documentation from source code, OpenAPI specs, or endpoint implementations.

Core Features & Use Cases

  • Inventory endpoints by resource and method, aligning implementation with the API contract.
  • Cross-reference OpenAPI specs with code to ensure accuracy and reduce drift.
  • Produce structured API docs suitable for developer portals, READMEs, and internal docs.

Quick Start

Provide the API source path to generate the API documentation.

Frequently Asked Questions about write-api-docs

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

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

You can generate API reference documentation by providing the API source path to parse source files, route definitions, and endpoint implementations into structured, comprehensive docs.

How do I cross-reference OpenAPI specs with my codebase to prevent documentation drift?

Cross-reference OpenAPI specs with your codebase by parsing both source files and definitions to align endpoint implementations with the API contract, ensuring accuracy and reducing drift.

Can I organize endpoints by resource and method across multiple services?

Yes, you can inventory endpoints by resource and method across multiple REST/HTTP services, organizing them into structured documentation suitable for developer portals and internal docs.

Do I need OpenAPI specs to generate API docs for my REST endpoints?

You do not strictly need OpenAPI specs; the documentation can be generated from code, OpenAPI specs, or endpoint implementations, and supports manual overrides for alignment.

What is the best way to create an endpoint inventory from route definitions?

Create an endpoint inventory by parsing route definitions and source files to map REST/HTTP endpoints by resource and method, producing a structured inventory aligned with the API contract.

Why does my generated API documentation not match the actual endpoint implementations?

Documentation may misalign with implementations due to drift; cross-referencing OpenAPI specs with source code ensures alignment, and manual overrides can correct discrepancies in the generated docs.