API Design Principles
Decides REST and GraphQL shapes before any endpoint is written.
Install
Ships scripts/plugin marketplace add wshobson/agents; /plugin install backend-development
When a new API is being designed, an existing one reshaped, or a team standard written.
- Author
- wshobson
- License
- MIT
The skill works through resource naming, status codes, pagination, versioning and error payloads as design decisions that have to be settled up front, because they are expensive to change once clients depend on them. GraphQL schemas get their own treatment: nullability, connection patterns and where a mutation boundary belongs. A design checklist and a REST template ship alongside the instructions.
Similar skills
Ponytail
SkillArgues for the smallest change that actually solves the problem.
API and Interface Design
SkillDesigns contracts that are hard to misuse and safe to change later.
Apollo GraphQL Skills
SkillFourteen skills for Apollo's GraphQL stack: schema design, federation, Router and client SDKs.
Comments(0)
Sign in to comment