API Discipline
REST/OpenAPI-Spezifikationen, die jeden Validator bestehen — mit Pflicht-Audit für Konsistenz über alle Endpoints hinweg.
Getestet · Funktioniert
Was es kann
Erzwingt Design-Disziplin für REST/OpenAPI bei neuen Spezifikationen, neuen Endpoints und Spec-Reviews: Ressourcennamen im Plural, ein einheitliches RFC-9457-Fehlermodell, Pagination- und Versionierungskonventionen, die einmal festgelegt und danach konsequent wiederverwendet werden, korrekte PUT/PATCH/POST/DELETE-Semantik, ein Breaking-Change-Diff bei jeder Änderung sowie ein verpflichtendes 10-Punkte-Konsistenz-Audit vor der Auslieferung. Getestet gegen einen Claude-Agenten ohne Skill, über 7 Aufgaben, bewertet mit echten Validatoren (Redocly, Spectral, oasdiff) statt mit Selbsteinschätzung.
Testbericht
Unser eigener Skill — getestet nach demselben Protokoll, offengelegt. Über 7 API-Design-/Review-Aufgaben, bewertet mit echten Validatoren (Redocly, Spectral, oasdiff), eliminierte der Skill strukturelle OpenAPI-Fehler (0 statt 18 zusammengenommen bei zwei neuen Spezifikationen), Konsistenzverletzungen über Endpoints hinweg (0 statt 6) und HTTP-Semantik-Fehler (0 statt 3) gegenüber dem Baseline-Agenten ohne Skill. Zwei echte Einschränkungen stehen offen in verdict.md, statt versteckt zu werden: Beim Review T6 mit eingebauten Verstößen verlor der Skill knapp (9/10 statt 10/10) und übersah einen 201-ohne-Location-Fund, den der Baseline-Agent erkannte. Die Breaking-Change-Aufgabe T4 wurde aus der Erfolgsbilanz herausgenommen, weil sich zeigte, dass der Skill-Durchlauf vor der Analyse bereits einen Hinweis auf die korrekte Lösung gesehen hatte. Der Protokolltest hat echte Probleme in unseren eigenen Repos aufgedeckt (tote Benchmark-Links, strenges YAML-Frontmatter) — noch am selben Tag behoben und erneut verifiziert.
Getestet am: 2026-07-11 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/Skillproofdev/api-discipline ~/.claude/skills/api-discipline
Befehle & Beispiel-Prompts
/api-disciplineREST/OpenAPI-Spezifikationen, die jeden Validator bestehen — mit Pflicht-Audit für Konsistenz über alle Endpoints hinweg.
Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):
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?