API Discipline
Validator-rene REST/OpenAPI-spesifikasjoner med obligatorisk konsistenssjekk på tvers av endepunkter.
Bestått
Hva den gjør
Håndhever REST/OpenAPI-designdisiplin i nye design, ved nye endepunkter og i spec-gjennomganger: ressursnavn i flertall, én delt RFC 9457-feilmodell, paginering/versjonering deklarert én gang og gjenbrukt, korrekt PUT/PATCH/POST/DELETE-semantikk, en breaking-change-diff ved hver endring, og en obligatorisk 10-punkts konsistenssjekk før levering. Benchmarket mot en ren Claude-agent på 7 oppgaver med mekaniske validatorer (Redocly, Spectral, oasdiff) i stedet for selvrapportert scoring.
Testrapport
Vår egen skill — testet under samme protokoll, avslørt. På tvers av 7 API-design-/gjennomgangsoppgaver, scoret med ekte validatorer (Redocly, Spectral, oasdiff), eliminerte skillen strukturelle OpenAPI-feil (0 mot 18 samlet på to nye spesifikasjoner), konsistensbrudd på tvers av endepunkter (0 mot 6) og HTTP-semantikkfeil (0 mot 3) sammenlignet med en ren agent uten skill. To reelle forbehold er publisert i verdict.md i stedet for skjult: skillen tapte T6-gjennomgangen av plantede brudd med ett funn (9/10 mot 10/10, den gikk glipp av et 201-uten-Location-funn den rene agenten fant), og T4-oppgaven om breaking changes er utelatt fra seiersclaimet fordi skill-armen viste seg å ha sett et fasit-hint før analysen. Protokolltesten avdekket reelle problemer i våre egne repoer (døde benchmark-lenker, streng YAML-frontmatter) — fikset og reverifisert samme dag.
Testet på: 2026-07-11 · Claude Code 2.x (agent harness)
Installer
git clone https://github.com/Skillproofdev/api-discipline ~/.claude/skills/api-discipline
Kommandoer og eksempelprompter
/api-disciplineValidator-rene REST/OpenAPI-spesifikasjoner med obligatorisk konsistenssjekk på tvers av endepunkter.
Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):
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?