api-doc-writer

Generate API reference documentation from source code using the Diátaxis Reference pattern.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/meriley/claude-code-skills --skill api-doc-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-doc-writer
Source: https://github.com/meriley/claude-code-skills/tree/main/skills/api-doc-writer
Command: npx skills add https://github.com/meriley/claude-code-skills --skill api-doc-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of comprehensive API reference documentation, ensuring accuracy and adherence to the Diátaxis Reference pattern, thereby saving significant developer time and improving documentation quality.

Core Features & Use Cases

  • Automated API Documentation: Generates structured reference docs directly from source code.
  • Signature Verification: Guarantees that documented API signatures precisely match the source code, eliminating discrepancies.
  • Diátaxis Compliance: Strictly follows the Diátaxis framework for information-oriented documentation.
  • Use Case: When a new API endpoint is developed, use this Skill to instantly generate its reference documentation, including parameters, return types, and error conditions, ensuring it's ready for developers.

Quick Start

Use the api-doc-writer skill to document the 'pkg/services/task' package.

Frequently Asked Questions about api-doc-writer

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

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

Generate API reference documentation by reading source code to extract exact method signatures, parameter types, return values, and error conditions, ensuring the output precisely matches the implementation without manual entry.

What is the Diátaxis Reference pattern for API documentation?

The Diátaxis Reference pattern is an information-oriented documentation framework that structures API references strictly around exact syntax and mechanics, keeping them separate from tutorials and guides to serve as a precise lookup resource.

How do I ensure method signatures in my API docs match the source code?

Ensure method signatures match by using documentation automation that verifies signatures directly against the source code, extracting parameter types and return values with zero fabrication tolerance to eliminate discrepancies.

Can I document public package interfaces using the Diátaxis framework?

Yes, you can document public APIs, packages, and interfaces by generating structured reference docs that extract exact method signatures, error conditions, and return values while strictly adhering to the Diátaxis framework.

What's the best way to automate API documentation for new endpoints?

Automate API documentation for new endpoints by reading the source code to instantly generate reference docs, including parameters, return types, and error conditions, ensuring they are accurate and ready for developers.

What are the limitations of automating API reference docs from source code?

Automating API reference docs from source code is limited to extracting exact method signatures, parameter types, return values, and error conditions, meaning it focuses strictly on reference patterns rather than conceptual guides or tutorials.