SkillProof tested Claude skills

API Contract Review

Reviderer Spring/REST-kontrollere for HTTP-verb, versjonering, statuskoder og kompatibilitet

av decebals · decebals/claude-code-java

Bestått ★ 8.8/10

API Contract Review — Reviderer Spring/REST-kontrollere for HTTP-verb, versjonering, statuskoder og kompatibilitet

Hva den gjør

Reviderer REST API-kontrollere (Java/Spring-fokusert) mot en 6-punkts sjekkliste som dekker HTTP-verb semantikk, URL-versjonering, DTO-vs-entitet-lekkasjer, statuskode-korrekthet, feilresponsformat, og bakoverkompatibilitet. Utløses når brukeren ber om å revidere en API, sjekke REST-endepunkter, eller før utgivelse av API-endringer. Sammenkobles med spring-boot-patterns, som skriver kontrollere mens denne reviderer dem.

Testrapport

Hentet SKILL.md + README via GitHub API/rå; begge refererte filer returnerer HTTP 200, frontmatter har navn+beskrivelse, ingen eksterne skript, ingen sikkerhetslukt (kun harmløse inline grep-tips). Skrev en SpringUserController med plantede problemer (GET-basert sletting, POST for idempotent oppdatering, ingen /v1/, entitet retur, null ved savn, Map status:200 body) og produserte to revisjoner. Baselinen fanget GET-sletting, null-retur, entitet-lekkasje, og manglende paginering, men savnet versjonering, feil PUT/POST verb, 200-med-status-body anti-mønster, og manglende @Valid; ferdighetsrevisjonen fanget alle disse og organiserte funn etter de 6 kategoriene mens den droppet irrelevant hygiene-støy (konstruktørinjeksjon). Utløser vurdering: laster på "review the REST endpoints in UserController", "check my API before I release", "are my HTTP verbs/status codes right"; laster korrekt IKKE på "write a new REST controller for orders" (opprettelse, ikke revisjon) eller "review my DB schema for indexing" (ikke REST) — 5/5.

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

Installer

git clone --depth 1 https://github.com/decebals/claude-code-java.git /tmp/api-contract-review-src
mkdir -p ~/.claude/skills
cp -R /tmp/api-contract-review-src/.claude/skills/api-contract-review ~/.claude/skills/api-contract-review
# Self-contained: SKILL.md + README.md only, no external scripts or deps.
# Java/Spring-oriented (Spring annotations, JPA entities), but the HTTP/REST
# checklist applies to any REST API. No API keys, no tools to install.

Kommandoer og eksempelprompter

  • /api-contract-reviewReviderer Spring/REST-kontrollere for HTTP-verb, versjonering, statuskoder og kompatibilitet

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

  • Review this API for backward compatibility issues
  • Check these endpoints for REST semantics violations
  • Review the API contract before releasing v2

Full rapport →