README Discipline
Code-fundierte READMEs: jede Aussage bis zu file:line zurückverfolgt, jeder Befehl geprüft ausführbar.
Getestet · Funktioniert
Was es kann
Zwingt README-Erstellung und -Audits dazu, jede Aussage vor dem Schreiben auf eine Quelle zurückzuführen: Features müssen im Code nachweisbar sein, Befehle müssen aus echten Manifesten kopiert und ausgeführt werden, und ein belegter Abschnitt zu Einschränkungen ist Pflicht. Getestet gegen Baseline-Agenten an 3 echten Open-Source-Repos, mit klarem Sieg bei Vollständigkeit und blinder Bewertung — wobei die Verringerung erfundener Aussagen nur knapp ausfällt und die Auswertung von einer einzigen Person vorgenommen wurde.
Testbericht
Unser eigener Skill — getestet nach demselben Protokoll, offengelegt. Der Bench-Test maß 3 eingefrorene Open-Source-Repos, Baseline gegen Skill-Agent: Der Skill erreichte 18/18 bei der Abschnittsvollständigkeit gegenüber 14/18, wurde 3:3 bevorzugt mit einem Vertrauenswert von 4,67 statt 3,67 und hatte weniger erfundene Aussagen (1 statt 2 — ein knapper Vorsprung, da beide Baselines korrekte Inhalte aus bestehender Dokumentation übernahmen). Im Verdict offengelegte Einschränkungen: nur eine Expertenbewertung statt des im Protokoll vorgesehenen Panels aus mindestens drei Entwicklern, N=3, und der Skill protokollierte seine eigene erfundene Aussage (eine Verwechslung von HTTP 400/500) statt sie zu verstecken. 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/readme-discipline ~/.claude/skills/readme-discipline
Befehle & Beispiel-Prompts
/readme-disciplineCode-fundierte READMEs: jede Aussage bis zu file:line zurückverfolgt, jeder Befehl geprüft ausführbar.
Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):
Write a README for this repoCan you review our README.md and flag anything that's inaccurate or outdated?I'm scaffolding a new npm package — generate the initial README along with package.json