create-api-design
Installation
SKILL.md
Create API Design
Overview
Design a complete, production-ready API from a feature specification or resource description. The output is a comprehensive API design document covering endpoints, schemas, error contracts, pagination, auth, rate limiting, and caching -- consistent with existing API patterns in the project.
Workflow
- Read existing API patterns -- Read
.chalk/docs/engineering/for:- Existing API design documents (match naming, URL structure, and conventions)
- Architecture docs describing the current API layer
- Auth patterns and middleware
- Error handling conventions
- If no docs exist, scan the codebase for route definitions to infer patterns