api-design
Installation
SKILL.md
API Design Lens
Philosophy: An API is a contract. Breaking it breaks your users' production systems. Design APIs for the client's needs, not the server's convenience.
Core Instincts
- API contracts are forever — breaking changes in v1 are unforgivable; version aggressively
- Design for the consumer — the client's workflow, not the server's data model, drives resource design
- Idempotency is non-negotiable — safe to retry = safe to build reliable systems on top of
- Errors must be informative — vague errors waste developer hours
- Consistency over cleverness — a boring, predictable API is a beloved API