API Design Reviewer

Systematisk REST/GraphQL API-gjennomgang med P0-P3 prioriterte funn, estimater for innsats, og en lanseringssjekkliste.

av shahtuyakov · shahtuyakov/claude-setup

Bestått ★ 8.4/10

API Design Reviewer — Systematisk REST/GraphQL API-gjennomgang med P0-P3 prioriterte funn, estimater for innsats, og en lanseringssjekkliste.

Hva den gjør

Går gjennom et API-design eller en implementasjon med en fast 10-seksjoners sjekkliste (autentisering, ressursdesign, feil, paginering, versjonering, idempotens, ytelse, validering, dokumentasjon, GraphQL-spesifikasjoner) og gir ut en strukturert rapport med kritiske/viktige/kjekt-å-ha-nivåer, hvert funn poengsatt P0-P3 med et tidsestimat. Utløses ved design, gjennomgang eller revisjon av REST/GraphQL/gRPC-endepunkter før en utgivelse.

Testrapport

Gjennomgikk en bevisst slurvete 4-rute Express-fil: en baseline-gjennomgang fanget allerede den åpenbare SQL-injeksjonen og manglende autentisering, men ferdighetens strukturerte sjekkliste avdekket i tillegg versjonering, håndtering av idempotensnøkkel for POST /orders-endepunktet, og rate limiting, deretter pakket alt inn i en prioritert P0-P3-rapport med estimater for innsats i stedet for en flat liste. Frontmatteren overselger gRPC-dekningen, skjønt — kroppen har ingen gRPC-spesifikk seksjon (ingen streaming, proto-versjonering, eller service-definisjons sjekkliste) til tross for at GraphQL får et fullt dedikert underavsnitt.

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

Installer

git clone https://github.com/shahtuyakov/claude-setup
mkdir -p ~/.claude/skills
cp -r claude-setup/skills/api-design-reviewer ~/.claude/skills/api-design-reviewer

Kommandoer og eksempelprompter

  • /api-design-reviewerSystematisk REST/GraphQL API-gjennomgang med P0-P3 prioriterte funn, estimater for innsats, og en lanseringssjekkliste.

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

  • Review my REST API endpoints for security and pagination issues.
  • Can you audit this GraphQL schema before we ship it to production?
  • Check my API design for versioning and idempotency gaps before launch.