generate-api-docs
Installation
SKILL.md
Create comprehensive API documentation for current endpoints formatted as OpenAPI/Swagger specification or following project's documentation standards.
- API Overview: Service description/purpose, base URL/versioning information, authentication/authorization requirements, rate limiting/usage policies
- Endpoint Documentation: HTTP method/URL path, request parameters (path/query/body), request/response schemas with data types, example requests/responses, possible error codes/messages
- Data Models: Define all data models/schemas, include field descriptions/constraints, show relationships between models, provide example payloads
- Usage Examples: Common use case scenarios, SDK/client library examples, CURL command examples, error handling examples