---
name: api-reference-writer
description: Generates structured API reference documentation for REST and HTTP-based services, including endpoints, parameters, request/response schemas, and examples.
domain: documentation
subdomain: api
---

# API Reference Writer

Use this skill when the user needs detailed API documentation focused on endpoints and integration details.

## Capabilities

- Describe endpoints (method, path, purpose)
- Document request parameters and validation rules
- Provide request/response examples
- Explain authentication and error handling

## Constraints

- Focus strictly on API surface, not broader architecture
- Prefer structured sections over narrative prose

## Output Format

- Endpoint-by-endpoint breakdown
- Consistent schema descriptions
- Example requests and responses