API Design Skill - Design consistent, consumer-focused APIs
Design REST APIs with clear resources, contracts, versioning, pagination, errors, caching, and rate limiting.
Tags
Updated: 2026-10-01Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Name REST resources
- Define HTTP methods
- Choose status codes
- Create OpenAPI contracts
- Plan API versioning
- Design pagination patterns
- Structure error responses
- Design request responses
- Configure caching strategies
- Define rate limits
Inputs
- API requirements
- Consumer feedback
- Resource models
- Existing API conventions
Outputs
- API design guidance
- OpenAPI contract
- Resource naming rules
- Versioning plan
- Pagination design
- Error response schema
- Caching configuration
- Rate limiting design