README Discipline
READMEs met een fundament in code: elke bewering herleid tot file:line, elk commando geverifieerd om echt te draaien.
Getest · Werkt
Wat het doet
Dwingt af dat het genereren en beoordelen van READMEs elke bewering eerst herleidt tot de bron voordat die wordt opgeschreven: features moeten terug te vinden zijn in de code, commando's moeten letterlijk uit echte manifests komen en daadwerkelijk draaien, en een onderbouwde sectie Limitations is verplicht. Getest tegen baseline-agents op 3 echte open-sourcerepo's, met een duidelijke winst op volledigheid en blinde voorkeur — al is de marge op minder verzinsels smal en gebeurde de beoordeling door één enkele beoordelaar.
Testrapport
Onze eigen skill — getest onder hetzelfde protocol, transparant vermeld. De bench mat 3 bevroren open-sourcerepo's, baseline versus skill-agent: de skill haalde 18/18 op sectievolledigheid tegenover 14/18, werd 3/3 keer verkozen met een trustscore van 4,67 tegenover 3,67, en had minder verzonnen beweringen (1 tegenover 2 — een smalle marge, omdat beide baselines correcte inhoud overnamen uit bestaande documentatie). Kanttekeningen die de verdict zelf meldt: één enkele expertbeoordelaar (niet het panel van ≥3 developers dat het protocol voorschrijft), N=3, en de skill noteerde zijn eigen verzinsel (een verwisseling tussen HTTP 400 en 500) in plaats van dat te verbergen. De protocoltest vond echte problemen in onze eigen repo's (dode benchmarklinks, strikte YAML-frontmatter) — dezelfde dag nog opgelost en opnieuw geverifieerd.
Getest op: 2026-07-11 · Claude Code 2.x (agent harness)
Installatie
git clone https://github.com/Skillproofdev/readme-discipline ~/.claude/skills/readme-discipline
Commando's en voorbeeldprompts
/readme-disciplineREADMEs met een fundament in code: elke bewering herleid tot file:line, elk commando geverifieerd om echt te draaien.
Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):
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