API Discipline
Des specs REST/OpenAPI propres selon les validateurs, avec un audit de cohérence inter-endpoints obligatoire.
Testé · Fonctionne
Ce que fait
Impose une discipline de conception REST/OpenAPI sur les nouvelles specs, les ajouts d'endpoints et les revues : noms de ressources au pluriel, un seul modèle d'erreur RFC 9457 partagé, conventions de pagination et de versioning déclarées une fois puis réutilisées, sémantique correcte de PUT/PATCH/POST/DELETE, un diff des breaking changes à chaque modification, et un audit de cohérence obligatoire en 10 points avant livraison. Comparé à un agent Claude sans skill sur 7 tâches, avec des validateurs mécaniques (Redocly, Spectral, oasdiff) plutôt qu'une notation auto-déclarée.
Rapport de test
Notre propre skill — testé selon le même protocole, en toute transparence. Sur 7 tâches de conception/revue d'API notées avec de vrais validateurs (Redocly, Spectral, oasdiff), le skill a éliminé les erreurs structurelles OpenAPI (0 contre 18 cumulées sur deux specs greenfield), les violations de cohérence inter-endpoints (0 contre 6) et les erreurs de sémantique HTTP (0 contre 3), face à un agent sans skill. Deux réserves bien réelles sont publiées dans verdict.md plutôt que passées sous silence : le skill a perdu la revue T6 à violations semées pour une seule d'entre elles (9/10 contre 10/10, une découverte 201-sans-Location manquée que l'agent de base avait repérée), et la tâche T4 sur les breaking changes est exclue du bilan car le bras avec skill avait vu un indice de vérité terrain avant l'analyse. Le test du protocole a détecté de vrais problèmes dans nos propres dépôts (liens de benchmark morts, frontmatter YAML strict) — corrigés et revérifiés le jour même.
Testé le: 2026-07-11 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/Skillproofdev/api-discipline ~/.claude/skills/api-discipline
Commandes et exemples de prompts
/api-disciplineDes specs REST/OpenAPI propres selon les validateurs, avec un audit de cohérence inter-endpoints obligatoire.
Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :
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?