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.
スキルの内容
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.
できること
- 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
概要
- 公開元
- Addy Osmani
インストール
- すべてのクライアントに追加するには、次のコマンドを実行します:
npx skills add addyosmani/agent-skills --skill api-and-interface-design
MCPサーバーやスキルは、お使いのコンピューターでコードを実行したり、データを操作したりできます。インストールする前にソースを確認してください。
詳細
| 項目 | 内容 | 出典 |
|---|---|---|
| 種類 | スキル | |
| ツール | ドキュメントに記載なし | |
| 公開元 | Addy Osmani | 出典 |
| 公式かどうか | ドキュメントに記載なし | |
| APIキーまたはサインインが必要 | ドキュメントに記載なし | |
| スクリプトを含む | いいえ | 出典 |
| プラットフォーム | ドキュメントに記載なし | |
| AIクライアント | Claude Code, Cursor, Codex, Gemini CLI, Devin Desktop | 出典 |
| ライセンス | MIT | 出典 |
| 料金 | ドキュメントに記載なし | |
| 活動状況 | 最終コミット 2026年11月1日GitHubスター 115,373ダウンロード数のデータなし(npm・PyPIで未公開) | 出典 |
| リンク | リポジトリ Webサイト |
ほかのリポジトリにあるこのスキルのコピー(12件)
このスキルとは内容が異なります。手を加えたコピーか、古いバージョンの可能性があります。
- 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
Addy Osmaniのほかの掲載
スキル24件
- ci-cd-and-automation (スキル)
- browser-testing-with-devtools (スキル)
- code-simplification (スキル)
- constraint-driven-development (スキル)
- code-review-and-quality (スキル)
- context-engineering (スキル)
出典
- GitHubリポジトリgithub.com/addyosmani/agent-skills · 根拠となる項目:AIクライアント, ライセンス, 公開元, 活動状況2026年11月11日
- Webページraw.githubusercontent.com · 根拠となる項目:スクリプトを含む2026年11月15日
- スキルファイル(SKILL.md)github.com/addyosmani/agent-skills2026年11月10日
- リポジトリ内のフォルダ(api-and-interface-design)github.com/addyosmani/agent-skills · 根拠となる項目:スクリプトを含む2026年11月10日