api-design-principles
A skill from Seth Hobson's agents collection, in its backend-development plugin, with principles for designing REST and GraphQL APIs and for reviewing API specifications or setting team standards.
スキルの内容
A skill from Seth Hobson's agents collection, in its backend-development plugin, with principles for designing REST and GraphQL APIs and for reviewing API specifications or setting team standards. For REST it covers resource-oriented URLs, HTTP method meaning, which methods are safe or idempotent, status codes and statelessness. For GraphQL it covers schema-first design, queries, mutations and subscriptions, cursor pagination in the Relay style and structured errors in mutation results. It compares three ways of versioning, and adds rate limiting, OpenAPI documentation, batching loaders to avoid repeated queries, deprecation and query complexity limits. Common mistakes include breaking changes, inconsistent errors and tying the API to the database schema.
できること
- Design resource-oriented REST endpoints
- Design GraphQL schemas with cursor pagination
- Choose an API versioning strategy
- Review an API specification for common mistakes
概要
- 公開元
- Seth Hobson
- ツール
- コードレビュー
インストール
プロジェクトのドキュメントに、確認できるインストール手順がありません。 プロジェクトの手順を見る
含まれるファイル
- assets/api-design-checklist.md
- assets/rest-api-template.py
- references/details.md
- references/graphql-schema-design.md
- references/rest-best-practices.md
MCPサーバーやスキルは、お使いのコンピューターでコードを実行したり、データを操作したりできます。インストールする前にソースを確認してください。
詳細
ほかのリポジトリにあるこのスキルのコピー(13件)
このスキルとは内容が異なります。手を加えたコピーか、古いバージョンの可能性があります。
- api-design-principlesrmyndharis/antigravity-skills
- api-design-principlesdokhacgiakhoa/agent-skills-4-vibe-coding-cli
- api-design-principlesmicrock/ordinary-claude-skills
- api-design-principlessecondsky/claude-skills
- api-design-principlesagent-skills-hub/agent-skills-hub
- api-design-principlesovachiever/droid-tings
- api-design-principleslifangda/claude-plugins
- api-design-principlesonfire7777/universal-ai-skills-library
- api-design-principlesjuankcadavid/akili-specs
- api-design-principlestmolavi/mcp-agent-skills-hub
- api-design-principlesscaleto/antigravity-super-skill-architecture
- api-design-principleshk-hub/agentskills
- api-design-principlescarlopezzuto/agents
Seth Hobsonのほかの掲載
スキル18件
- gitlab-ci-patterns (スキル)
- multi-cloud-architecture (スキル)
- terraform-module-library (スキル)
- godot-gdscript-patterns (スキル)
- unity-ecs-patterns (スキル)
- k8s-manifest-generator (スキル)
こちらにも掲載: コードレビュー
出典
- スキルファイル(SKILL.md)github.com/wshobson/agents2026年11月10日
- GitHubリポジトリgithub.com/wshobson/agents · 根拠となる項目:公開元, 活動状況, ライセンス2026年11月11日
- リポジトリ内のフォルダ(api-design-principles)github.com/wshobson/agents · 根拠となる項目:スクリプトを含む2026年11月10日