API Discipline
Validator-schone REST/OpenAPI-specs met een verplichte consistentiecheck tussen endpoints.
Getest · Werkt
Wat het doet
Dwingt REST/OpenAPI-ontwerpdiscipline af bij nieuwe designs, endpoint-toevoegingen en spec-reviews: resourcenamen in het meervoud, één gedeeld RFC 9457-foutmodel, paginering- en versioneringsconventies die één keer worden vastgelegd en daarna hergebruikt, correcte PUT/PATCH/POST/DELETE-semantiek, een breaking-change-diff bij elke wijziging, en een verplichte 10-punts consistentiecheck vóór oplevering. Getest tegen een kale Claude-agent op 7 taken met mechanische validators (Redocly, Spectral, oasdiff) in plaats van zelfgerapporteerde scores.
Testrapport
Onze eigen skill — getest onder hetzelfde protocol, transparant vermeld. Over 7 API-ontwerp/review-taken, gescoord met echte validators (Redocly, Spectral, oasdiff), elimineerde de skill structurele OpenAPI-fouten (0 versus 18 samen op twee nieuwe specs), consistentieschendingen tussen endpoints (0 versus 6) en HTTP-semantiekfouten (0 versus 3) ten opzichte van een kale agent zonder skill. Twee echte kanttekeningen staan gewoon in verdict.md, niet verstopt: de skill verloor de T6-review met geplante schendingen op één punt (9/10 tegenover 10/10 — een 201-zonder-Location-bevinding die de kale agent wél zag, werd gemist), en de T4-breaking-change-taak telt niet mee voor de winst omdat bleek dat de skill-arm al een ground-truth-hint had gezien vóór de analyse. De protocoltest vond echte problemen in onze eigen repo's (dode benchmarklinks, strikte YAML-frontmatter) — dezelfde dag nog opgelost en opnieuw geverifieerd.
Getest op: 2026-07-11 · Claude Code 2.x (agent harness)
Installatie
git clone https://github.com/Skillproofdev/api-discipline ~/.claude/skills/api-discipline
Commando's en voorbeeldprompts
/api-disciplineValidator-schone REST/OpenAPI-specs met een verplichte consistentiecheck tussen endpoints.
Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):
Design a REST API for a project management tool with users, projects, and tasks.Add an endpoint to cancel an order in our existing OpenAPI spec — here's the current spec.yaml.Should I use PUT or PATCH to update a single field on a user resource?