API Discipline
Specyfikacje REST/OpenAPI czyste dla walidatorów, z obowiązkowym audytem spójności między endpointami.
Testowano · Działa
Co robi ten skill
Wymusza dyscyplinę projektowania REST/OpenAPI przy projektach od zera, dodawaniu endpointów i przeglądach specyfikacji: nazewnictwo zasobów w liczbie mnogiej, jeden wspólny model błędów zgodny z RFC 9457, konwencje paginacji i wersjonowania zadeklarowane raz i konsekwentnie stosowane, poprawną semantykę PUT/PATCH/POST/DELETE, diff zmian łamiących kompatybilność przy każdej edycji oraz obowiązkowy 10-punktowy audyt spójności przed dostarczeniem. Zbenchmarkowane względem czystego agenta Claude na 7 zadaniach, z użyciem mechanicznych walidatorów (Redocly, Spectral, oasdiff) zamiast ocen deklarowanych przez model.
Raport z testu
Nasz własny skill — testowany według tego samego protokołu, jawnie to zaznaczamy. W 7 zadaniach projektowania/przeglądu API ocenianych realnymi walidatorami (Redocly, Spectral, oasdiff) skill wyeliminował błędy strukturalne OpenAPI (0 vs 18 łącznie w dwóch specyfikacjach od zera), naruszenia spójności między endpointami (0 vs 6) i błędy semantyki HTTP (0 vs 3) w porównaniu z bazowym agentem. Dwa realne zastrzeżenia są opublikowane w verdict.md, a nie ukryte: skill przegrał przegląd T6 z podsadzonymi błędami o jeden przypadek (9/10 vs 10/10, brakło wykrycia 201 bez nagłówka Location, które złapał czysty agent), a zadanie T4 dotyczące zmian łamiących kompatybilność zostało wyłączone z wyniku, bo okazało się, że wariant ze skillem zobaczył podpowiedź z prawidłową odpowiedzią przed analizą. Test protokołu wykrył realne problemy w naszych własnych repozytoriach (martwe linki do benchmarków, zbyt rygorystyczny YAML frontmatter) — naprawione i ponownie zweryfikowane tego samego dnia.
Testowano: 2026-07-11 · Claude Code 2.x (agent harness)
Instalacja
git clone https://github.com/Skillproofdev/api-discipline ~/.claude/skills/api-discipline
Komendy i przykładowe prompty
/api-disciplineSpecyfikacje REST/OpenAPI czyste dla walidatorów, z obowiązkowym audytem spójności między endpointami.
Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):
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?