sk Skill · addyosmani
api-and-interface-design
Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend.
Open on skills.sh ↗read 2026-09-18
- installs 8w
- 20,823
- 30-day movement
- starts with the next reading
- Related entries
- 9
- Connections
- 0
typescriptJavaScript
An agent skill that guides stable API and interface design, covering REST patterns, TypeScript interface patterns, and principles like contract-first design and consistent error semantics. It is structured as an overview, when-to-use guidance, principles, pitfalls, and a checklist.
Reach for it when you need a structured reference for designing endpoints, module boundaries, or type contracts that are hard to misuse.
Use it to
- Design new REST or GraphQL endpoints
- Define type contracts between modules
- Establish frontend/backend boundaries
- Review an API for inconsistent error handling
- Plan pagination and filtering for list endpoints
For Developers designing APIs or module interfaces
- Host repository
- addyosmani/agent-skills
- Installs, lifetime
- 35k
- Installs, 8 weeks
- 21k
- Host stars
- 96k
- Host language
- JavaScript
topicsapi-designinterfacesrestgraphqltypescriptskill