api-documentation-writer

Generate structured API documentation with endpoint examples and authentication guides.

1|Updated May 12, 2026
One-click install
npx skills add https://github.com/MoxyWolfLLC/moxywolf-plugins --skill api-documentation-writer-moxywolfllc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-documentation-writer
Source: https://github.com/MoxyWolfLLC/moxywolf-plugins/tree/main/skill-bundles/moxywolf-skills/skills/api-documentation-writer
Command: npx skills add https://github.com/MoxyWolfLLC/moxywolf-plugins --skill api-documentation-writer-moxywolfllc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Producing accurate, complete API documentation is slow and error-prone, especially when endpoints, auth, examples, and error formats are spread across multiple sources.

Core Features & Use Cases

  • Comprehensive developer documentation: Generates structured docs covering overview, auth, base URL/versioning, endpoints (with parameters, schemas, examples, and response codes), error handling, rate limits, and SDK/library guidance.
  • OpenAPI/Swagger-ready output: Produces specification-structured REST API documentation suitable for integration and reference, including developer-friendly reference materials.
  • GraphQL adaptation: When needed, adapts the documentation approach to match GraphQL artifacts like schema, queries, mutations, variables, and subscriptions.

Quick Start

Ask to write API documentation for your REST or GraphQL API and specify the authentication method, base URL/versioning, and at least the list of endpoints you want documented.

Frequently Asked Questions about api-documentation-writer

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

FAQPage Schema
How do I generate API documentation from endpoint details?

To generate API documentation, provide structured input for your API type, auth method, base URL, versioning, and endpoint schemas. The tool transforms these raw details into organized developer-facing reference materials, including request/response examples and rate limiting patterns for successful client integration.

Can I create OpenAPI or Swagger reference materials automatically?

Yes, you can create OpenAPI or Swagger-ready output by providing your REST endpoint schemas and constraints. The process produces specification-structured documentation suitable for integration, generating developer-friendly reference materials, error codes, and code examples.

Does this approach work for generating GraphQL schema documentation?

Yes, generating GraphQL documentation is supported by adapting the output to match GraphQL artifacts. When you supply your schema details, it produces documentation covering queries, mutations, variables, and subscriptions instead of standard REST endpoint references.

What do I need to prepare before writing API documentation?

Before writing API documentation, you need to define your API type, authentication method, base URL, versioning scheme, and endpoint schemas. Gathering your usage constraints, such as rate limits and pagination patterns, ensures the generated reference materials are complete and accurate.

What is the best way to document API authentication and error handling?

The best way to document API authentication and error handling is to supply your auth method and error formats as structured input. This yields comprehensive developer documentation that clearly explains auth guides, error codes, and rate limiting within the same reference.