API Design Principles

Anvender REST- og GraphQL-designprincipper til at bygge klare, skalerbare API'er.

Af wshobson · wshobson/agents

Tested · Didn't pass

API Design Principles — Anvender REST- og GraphQL-designprincipper til at bygge klare, skalerbare API'er.

Hvad det gør

Mestrer REST- og GraphQL API-designprincipper til at bygge intuitive, skalerbare og vedligeholdelsesvenlige API'er, der glæder udviklere. Brug det, når du designer nye API'er, gennemgår API-specifikationer eller fastlægger standarder for API-design.

Testrapport

Testede en REST-designopgave (en bogmærketjeneste: endpoints, versionering, paginering, JSON-eksempler) med og uden skillet. Begge forsøg gav korrekte, komplette designs med ressourceorienterede endpoints og URL-versionering; skill-forsøget var fuldt best-practice-kompatibelt, men valgte offset/page-paginering, mens basisforsøget selvstændigt nåede frem til det stærkere cursor-baserede valg med skarpere begrundelse. Installation og frontmatter var rene ved verbatim-installation; skillet giver ikke et målbart løft over en dygtig basismodel på denne opgave.

Testet: 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

Kommandoer og eksempelprompter

  • /api-design-principlesAnvender REST- og GraphQL-designprincipper til at bygge klare, skalerbare API'er.

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

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