API Discipline
Validatorrena REST/OpenAPI-specar med obligatorisk konsekvenskontroll mellan endpoints.
Testad · Fungerar
Vad den gör
Upprätthåller disciplin i REST/OpenAPI-design för nya specar, tillagda endpoints och granskningar: resursnamn i plural, en delad RFC 9457-felmodell, pagination- och versionskonventioner som deklareras en gång och återanvänds, korrekt PUT/PATCH/POST/DELETE-semantik, en breaking-change-diff vid varje ändring, och en obligatorisk 10-punkters konsekvenskontroll före leverans. Benchmarkad mot en ren Claude-agent på 7 uppgifter med mekaniska validatorer (Redocly, Spectral, oasdiff) i stället för självrapporterad poängsättning.
Testrapport
Vår egen skill — testad enligt samma protokoll, öppet redovisat. I 7 API-design-/granskningsuppgifter poängsatta med riktiga validatorer (Redocly, Spectral, oasdiff) eliminerade skillen strukturella OpenAPI-fel (0 mot 18 sammanlagt på två nya specar), konsekvensbrott mellan endpoints (0 mot 6) och HTTP-semantikfel (0 mot 3) jämfört med en ren agent utan skill. Två verkliga brasklappar publiceras i verdict.md i stället för att gömmas undan: skillen förlorade T6-granskningen av inplanterade fel med en enda markering (9/10 mot 10/10 — den missade ett 201-utan-Location-fynd som den rena agenten hittade), och T4-uppgiften om breaking changes räknas inte in i vinsten eftersom skill-armen visade sig ha sett en ledtråd om facit innan analysen. Protokolltestet hittade verkliga problem i våra egna repos (döda benchmark-länkar, sträng YAML-frontmatter) — åtgärdat och verifierat på nytt samma dag.
Testad: 2026-07-11 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/Skillproofdev/api-discipline ~/.claude/skills/api-discipline
Kommandon och exempelprompter
/api-disciplineValidatorrena REST/OpenAPI-specar med obligatorisk konsekvenskontroll mellan endpoints.
Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):
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?