README Doctor
9-Punkte-README-Rubrik mit P0/P1/P2-Punchlist, beweisgestützt und kategorie-/zielgruppenbewusst.
Funktioniert mit Setup
Was es kann
Auditiert ein README anhand einer 9-Kriterien-Rubrik (Hero-Präsenz, Installations-zu-erster-Erfolgs-Länge, der 'Was ist das'-Satz, Übereinstimmung von Zielgruppen-Jargon, Scannbarkeit, Drift-Signale wie veraltete Versionen und Badge-Sprawl, Beitragsfläche), gewichtet nach abgeleitetem Repository-Kategorie und Zielgruppe, und gibt dann eine priorisierte Punchlist mit zeilenbasierten Beweisen aus. Löst bei Anfragen zur Auditierung, Überprüfung oder Diagnose aus, warum ein README nicht ankommt; überschreibt explizit keine Prosa und lintet keine Markdown-Syntax.
Testbericht
Abschnitt 1.1 ('operating mode') und der PR-Öffnungsschritt in Phase 4 sagen beide 'same as repo-visuals', ohne die Modi inline zu definieren – repo-visuals lebt in einem separaten Plugin (plugins/repo-visuals), das nicht mit readme-doctor gebündelt ist, sodass eine wortgetreue Installation diesen Teil vermisst; die Kern-9-Punkte-Audit-Rubrik selbst ist vollständig in sich geschlossen und produzierte eine scharfe, beweisgestützte, priorisierte Punchlist für ein Test-README.
Getestet am: 2026-07-15 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/livlign/claude-skills cd claude-skills mkdir -p ~/.claude/skills cp -r plugins/repo-doctor/skills/readme-doctor ~/.claude/skills/readme-doctor
Befehle & Beispiel-Prompts
/readme-doctor9-Punkte-README-Rubrik mit P0/P1/P2-Punchlist, beweisgestützt und kategorie-/zielgruppenbewusst.
Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):
why isn't my README landing with new visitors, what's missingaudit this README and give me a prioritized list of fixesdoes my project's README explain what it does fast enough