API Design Reviewer

Systematická revize API REST/GraphQL s prioritizovanými nálezy P0-P3, odhady náročnosti a kontrolním seznamem pro spuštění.

od shahtuyakov · shahtuyakov/claude-setup

Otestováno · Funguje ★ 8.4/10

API Design Reviewer — Systematická revize API REST/GraphQL s prioritizovanými nálezy P0-P3, odhady náročnosti a kontrolním seznamem pro spuštění.

Co umí

Provede návrh nebo implementaci API pevným 10sekčním kontrolním seznamem (autentizace, návrh zdroje, chyby, stránkování, verzování, idempotence, výkon, validace, dokumentace, specifika GraphQL) a vygeneruje strukturovanou zprávu s kritickými/důležitými/příjemnými úrovněmi, přičemž každý nález je skórován P0-P3 s odhadem času. Spouští se při návrhu, revizi nebo auditu koncových bodů REST/GraphQL/gRPC před vydáním.

Testovací report

Zkontroloval záměrně nepořádný 4-cestný soubor Express: základní průchod již zachytil zjevnou SQL injekci a chybějící autentizaci, ale strukturovaný kontrolní seznam dovednosti navíc odhalil verzování, zpracování klíče pro idempotenci pro koncový bod POST /orders a omezení rychlosti, poté vše zabalil do prioritizované zprávy P0-P3 s odhady náročnosti místo plochého seznamu. Předmluva přehnaně zdůrazňuje pokrytí gRPC — tělo však nemá žádnou sekci specifickou pro gRPC (žádné streamování, verzování proto nebo kontrolní seznam definice služby), přestože GraphQL dostává plnohodnotnou dedikovanou podsekci.

Testováno: 2026-07-15 · Claude Code 2.x (agent harness)

Instalace

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

Příkazy a ukázkové prompty

  • /api-design-reviewerSystematická revize API REST/GraphQL s prioritizovanými nálezy P0-P3, odhady náročnosti a kontrolním seznamem pro spuštění.

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

  • 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.