API Design Principles

Tillämpar REST- och GraphQL-designprinciper för att bygga tydliga, skalbara API:er.

av wshobson · wshobson/agents

Tested · Didn't pass

API Design Principles — Tillämpar REST- och GraphQL-designprinciper för att bygga tydliga, skalbara API:er.

Vad den gör

Bemästra REST- och GraphQL-API-designprinciper för att bygga intuitiva, skalbara och underhållbara API:er som gläder utvecklare. Använd när du designar nya API:er, granskar API-specifikationer eller etablerar standarder för API-design.

Testrapport

Testade en REST-designuppgift (bokmärkestjänst: endpoints, versionering, pagination, JSON-exempel) med och utan skillen. Båda armarna producerade korrekta, kompletta designer med resursorienterade endpoints och URL-versionering; skill-armen var helt best-practice-kompatibel men valde offset/sid-pagination, medan bas-armen självständigt nådde det starkare cursor-baserade valet med skarpare motivering. Installation ord för ord och frontmatter var rena; skillen ger inget mätbart lyft över en kapabel basmodell på den här uppgiften.

Testad: 2026-07-11 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/wshobson/agents
cd agents
mkdir -p ~/.claude/skills
cp -r plugins/backend-development/skills/api-design-principles ~/.claude/skills/api-design-principles

Kommandon och exempelprompter

  • /api-design-principlesTillämpar REST- och GraphQL-designprinciper för att bygga tydliga, skalbara API:er.

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

  • Review this REST API design for consistency issues
  • Design a GraphQL schema following best practices
  • Set API design standards for our new service