API Discipline
Validator-rene REST/OpenAPI-specifikationer med et obligatorisk konsistenstjek på tværs af endpoints.
Testet · Virker
Hvad det gør
Håndhæver disciplin for REST/OpenAPI-design ved nye designs, tilføjelse af endpoints og gennemgang af specifikationer: navngivning af ressourcer i flertal, én fælles RFC 9457-fejlmodel, konventioner for paginering/versionering der defineres én gang og genbruges, korrekt semantik for PUT/PATCH/POST/DELETE, en breaking-change-diff ved hver ændring og et obligatorisk 10-punkts konsistenstjek før levering. Benchmarket mod en bar Claude-agent på 7 opgaver med mekaniske validatorer (Redocly, Spectral, oasdiff) i stedet for selvrapporteret scoring.
Testrapport
Vores eget skill — testet efter samme protokol, og det oplyser vi åbent. På tværs af 7 API-design-/reviewopgaver, scoret med rigtige validatorer (Redocly, Spectral, oasdiff), eliminerede skillet strukturelle OpenAPI-fejl (0 mod 18 samlet på to nye specifikationer), konsistensbrud på tværs af endpoints (0 mod 6) og fejl i HTTP-semantik (0 mod 3) sammenlignet med en bar agent uden skillet. To reelle forbehold er offentliggjort i verdict.md i stedet for at blive skjult: skillet tabte T6-reviewet med sået fejl med én enkelt sag (9/10 mod 10/10 — det overså et 201-uden-Location-fund, som den bare agent fangede), og T4-opgaven om breaking changes er udelukket fra sejrsopgørelsen, fordi skill-armen viste sig at have set et facit-hint, inden den analyserede. Protokoltesten fangede reelle problemer i vores egne repos (døde benchmark-links, striks YAML-frontmatter) — rettet og genverificeret samme dag.
Testet: 2026-07-11 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/Skillproofdev/api-discipline ~/.claude/skills/api-discipline
Kommandoer og eksempelprompter
/api-disciplineValidator-rene REST/OpenAPI-specifikationer med et obligatorisk konsistenstjek på tværs af endpoints.
Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen 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?