api-and-interface-design
A skill from Addy Osmani's agent-skills collection for designing stable APIs and interfaces, such as REST or GraphQL endpoints, module boundaries, type contracts and the boundary between frontend and backend.
What the skill teaches
A skill from Addy Osmani's agent-skills collection for designing stable APIs and interfaces, such as REST or GraphQL endpoints, module boundaries, type contracts and the boundary between frontend and backend. It reminds the agent that any observable behaviour becomes something callers depend on, asks for the contract before the implementation, one error format everywhere, validation only at the edges, additive changes over breaking ones and predictable naming, and explains how to handle idempotency keys safely. It includes REST and TypeScript patterns, a verification checklist and warning signs such as unpaginated lists or verbs in URLs. It has no scripts.
Capabilities
- Design REST and GraphQL endpoints and type contracts
- Keep API changes additive and errors consistent
- Handle idempotency keys safely
- Check an API against a design checklist
About
- Publisher
- Addy Osmani
Install
- Run this to add it to Any client:
npx skills add addyosmani/agent-skills --skill api-and-interface-design
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Not stated in its documentation | |
| Publisher | Addy Osmani | source |
| Official status | Not stated in its documentation | |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | No | source |
| Platforms | Not stated in its documentation | |
| AI clients | Claude Code, Cursor, Codex, Gemini CLI, Devin Desktop | source |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 1, 2026115,373 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
Copies of this skill in other repositories (12)
These differ from this skill's text. They may be adapted copies or older versions.
- api-and-interface-designkevinke93/dev_agent_opc
- api-and-interface-designjmxt3/gitscape.ai
- api-and-interface-designborhen68/skillengine
- api-and-interface-designmanu14357/zskills
- api-and-interface-designkevinnft/ai-agent-skills
- api-and-interface-designhamza-ali-shahjahan/hamzaish
- api-and-interface-designchonsong/skill-retriever
- api-and-interface-designpeterblazejewicz/claude-plugins
- api-and-interface-designhk-hub/agentskills
- api-and-interface-designdanielvogler/agent-harness-config
- api-and-interface-designminghou-lei/codex-skills
- api-and-interface-designlaabadiadelcrimen/abadia-mcp
More from Addy Osmani
22 skills
- ci-cd-and-automation (Skill)
- browser-testing-with-devtools (Skill)
- code-simplification (Skill)
- constraint-driven-development (Skill)
- code-review-and-quality (Skill)
- context-engineering (Skill)
Sources
- GitHub repositorygithub.com/addyosmani/agent-skills · Backs: AI clients, Licence, Publisher, ActivityNov 11, 2026
- Web pageraw.githubusercontent.com · Backs: Includes scriptsNov 15, 2026
- Skill file (SKILL.md)github.com/addyosmani/agent-skillsNov 10, 2026
- Folder in the repository (api-and-interface-design)github.com/addyosmani/agent-skills · Backs: Includes scriptsNov 10, 2026