API Discipline
Specifikace REST/OpenAPI bez chyb validátoru s povinným auditem konzistence mezi endpointy.
Otestováno · Funguje
Co umí
Vynucuje disciplínu návrhu REST/OpenAPI u nových specifikací, přidávání endpointů i revizí: pojmenování zdrojů v množném čísle, jeden sdílený chybový model podle RFC 9457, konvence pro stránkování a verzování definované jednou a dál jen znovupoužívané, správnou sémantiku PUT/PATCH/POST/DELETE, diff breaking changes u každé úpravy a povinný desetibodový audit konzistence před odevzdáním. Testováno proti holému Claude agentovi na 7 úlohách pomocí strojových validátorů (Redocly, Spectral, oasdiff), ne podle vlastního hodnocení.
Testovací report
Náš vlastní skill — testovaný podle stejného protokolu, otevřeně přiznáno. Na 7 úlohách návrhu/revize API hodnocených reálnými validátory (Redocly, Spectral, oasdiff) skill oproti holému agentovi odstranil strukturální chyby OpenAPI (0 vs. 18 dohromady u dvou nových specifikací), porušení konzistence mezi endpointy (0 vs. 6) i chyby v HTTP sémantice (0 vs. 3). Ve verdict.md jsou zveřejněné i dva reálné háčky, ne skryté: u revize T6 se záměrně vloženými chybami skill prohrál o jeden nález (9/10 vs. 10/10) — chyběl mu nález 201 bez Location, který holý agent odhalil, a úloha T4 s breaking change je z vítězství vyřazená, protože se zjistilo, že varianta se skillem viděla nápovědu se správným řešením ještě před analýzou. Test protokolu odhalil reálné problémy v našich vlastních repozitářích (mrtvé odkazy na benchmarky, přísný YAML frontmatter) — opraveno a znovu ověřeno tentýž den.
Testováno: 2026-07-11 · Claude Code 2.x (agent harness)
Instalace
git clone https://github.com/Skillproofdev/api-discipline ~/.claude/skills/api-discipline
Příkazy a ukázkové prompty
/api-disciplineSpecifikace REST/OpenAPI bez chyb validátoru s povinným auditem konzistence mezi endpointy.
Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):
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?