---
name: api-documentation
description: Document one endpoint, a group of endpoints, or an entire API using the api-doc-writer agent.
---

# API Documentation

Use this skill when the user asks to document one endpoint, a group of endpoints, or an entire API.

Steps:
1. Read the OpenAPI definition.
2. Select the requested endpoints.
3. Use the `api-doc-writer` custom agent.
4. Generate Markdown documentation in `output/documentation/`.
5. Validate that every document includes purpose, authentication, parameters, examples, success response, and error responses.
6. Report missing OpenAPI details instead of inventing them.