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.
O que a skill ensina
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.
O que faz
- 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
Sobre
- Publicador
- Addy Osmani
Funciona com
Instalação
- Execute este comando para adicionar ao Qualquer cliente:
npx skills add addyosmani/agent-skills --skill api-and-interface-design
Servidores MCP e skills podem executar código no seu computador e agir sobre os seus dados. Revise o código-fonte antes de instalar.
Detalhes
| Fato | Valor | Fonte |
|---|---|---|
| Tipo | Skill | |
| Ferramenta | Não informado na documentação | |
| Publicador | Addy Osmani | fonte |
| Status oficial | Não informado na documentação | |
| Exige chave de API ou login | Não informado na documentação | |
| Inclui scripts | Não | fonte |
| Plataformas | Não informado na documentação | |
| Clientes de IA | Claude Code, Cursor, Codex, Gemini CLI, Devin Desktop | fonte |
| Licença | MIT | fonte |
| Preço | Não informado na documentação | |
| Atividade | Último commit em 1 de nov. de 2026115.373 estrelas no GitHubDados de download indisponíveis (não está no npm nem no PyPI) | fonte |
| Links | Repositório Site |
Outras cópias desta skill (12)
Elas têm diferenças no texto em relação a esta skill. Podem ser cópias adaptadas ou versões mais antigas.
- 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
Mais de Addy Osmani
25 skills
- ci-cd-and-automation (Skill)
- browser-testing-with-devtools (Skill)
- code-simplification (Skill)
- constraint-driven-development (Skill)
- using-agent-skills (Skill)
- code-review-and-quality (Skill)
Fontes
- Repositório no GitHubgithub.com/addyosmani/agent-skills · Comprova: Clientes de IA, Licença, Publicador, Atividade11 de nov. de 2026
- Página webraw.githubusercontent.com · Comprova: Inclui scripts15 de nov. de 2026
- Arquivo da skill (SKILL.md)github.com/addyosmani/agent-skills10 de nov. de 2026
- Pasta no repositório (api-and-interface-design)github.com/addyosmani/agent-skills · Comprova: Inclui scripts10 de nov. de 2026