API Documentation

Overview

Comprehensive API documentation skill covering OpenAPI/Swagger specifications, endpoint documentation, authentication flows, error handling, versioning strategies, and SDK/client documentation. Combines technical precision with clear, user-friendly writing to create documentation that developers can actually use.

Instructions

1. Understand the API First

• Review all endpoints and their purposes
• Identify authentication mechanisms
• Understand request/response schemas
• Note error conditions and edge cases
• Check existing API patterns for consistency

2. Documentation Components

Every API should document: