API Discipline
Spec REST/OpenAPI pulite ai validator, con un audit di coerenza tra endpoint obbligatorio.
Promosso
Cosa fa
Impone disciplina di design REST/OpenAPI su progetti nuovi, aggiunte di endpoint e revisioni di spec: nomi delle risorse al plurale, un unico modello di errore RFC 9457 condiviso, convenzioni di paginazione e versioning dichiarate una volta sola e riusate, semantica corretta di PUT/PATCH/POST/DELETE, un diff dei breaking change a ogni modifica e un audit di coerenza obbligatorio in 10 punti prima della consegna. Confrontato con un agente Claude senza skill su 7 task, valutato con validator meccanici (Redocly, Spectral, oasdiff) invece che con punteggi autodichiarati.
Rapporto di test
Skill nostro — testato con lo stesso protocollo, dichiarato apertamente. Su 7 task di design/revisione API valutati con validator reali (Redocly, Spectral, oasdiff), lo skill ha azzerato gli errori strutturali OpenAPI (0 contro 18 in totale su due spec nuove), le violazioni di coerenza tra endpoint (0 contro 6) e gli errori di semantica HTTP (0 contro 3) rispetto a un agente senza skill. Due limiti reali sono pubblicati nel verdict.md invece che nascosti: lo skill ha perso la revisione T6 sulle violazioni seminate per un solo caso (9/10 contro 10/10, mancandogli un riscontro di 201 senza Location che l'agente senza skill aveva trovato), e il task T4 sui breaking change è escluso dal computo delle vittorie perché è emerso che il ramo con skill aveva visto un indizio della risposta corretta prima di analizzare. Il test di protocollo ha trovato problemi reali nei nostri stessi repo (link ai benchmark morti, frontmatter YAML troppo rigido) — corretti e riverificati lo stesso giorno.
Testato il: 2026-07-11 · Claude Code 2.x (agent harness)
Installazione
git clone https://github.com/Skillproofdev/api-discipline ~/.claude/skills/api-discipline
Comandi e prompt di esempio
/api-disciplineSpec REST/OpenAPI pulite ai validator, con un audit di coerenza tra endpoint obbligatorio.
Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):
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?