API Design Principles

Bruker REST- og GraphQL-designprinsipper til å bygge klare, skalerbare API-er.

av wshobson · wshobson/agents

Tested · Didn't pass

API Design Principles — Bruker REST- og GraphQL-designprinsipper til å bygge klare, skalerbare API-er.

Hva den gjør

Mestre REST- og GraphQL API-designprinsipper for å bygge intuitive, skalerbare og vedlikeholdbare API-er som gleder utviklere. Bruk når du designer nye API-er, gjennomgår API-spesifikasjoner, eller etablerer standarder for API-design.

Testrapport

Testet en REST-designoppgave (bokmerketjeneste: endepunkter, versjonering, paginering, JSON-eksempler) med og uten skillet. Begge armene produserte korrekte, komplette design med ressursorienterte endepunkter og URL-versjonering; skill-armen var fullt i tråd med beste praksis, men valgte offset/side-paginering, mens base-armen på egen hånd landet på det sterkere cursor-baserte valget med skarpere begrunnelse. Verbatim installasjon og frontmatter var rene; skillet gir ikke noe målbart løft over en kapabel basismodell på denne oppgaven.

Testet på: 2026-07-11 · Claude Code 2.x (agent harness)

Installer

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-principlesBruker REST- og GraphQL-designprinsipper til å bygge klare, skalerbare API-er.

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen 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