Doc Cleanup
Zwei-Pass-Markdown-Rot-Audit: evidenzbasierte Diagnose, Bearbeitungen nur nach Genehmigung
Getestet · Funktioniert
Was es kann
Prüft das Markdown eines Repositories auf Kontextverfall – abgeschlossene Checklisten, die noch als Anweisungen geschrieben sind, ausgelieferte Pläne, die noch als Absicht geschrieben sind, veraltete Zählungen, tote Pfade und widersprüchliche Wahrheitsquellen – und erfordert Repository-Beweise für jede Feststellung, bevor eine Korrektur vorgeschlagen wird. Führt zuerst eine Diagnose und Berichterstattung durch und stoppt zur Genehmigung, dann wird mit einem Archivierungs- und Umschreibungs-Playbook und einem Link-/Diff-Verifizierungslauf ausgeführt. Wird bei Anfragen zum Überprüfen, Bereinigen oder Faktenprüfen von Projektdokumenten, CLAUDE.md oder AGENTS.md ausgelöst.
Testbericht
Auf die Einstiegsdokumente und den docs/-Ordner eines Live-Astro-Katalog-Repos gerichtet. Ohne den Skill erstellte ich vier Eindrücke ("Zahlen sehen veraltet aus", "es gibt eine doppelte Protokolldatei"); damit dreizehn Befunde, die jeweils eine ausgeführte Prüfung überstanden – README behauptet 64 Skills, wo skills.json 2433 enthält, behauptet 12 Kategorien in einem Absatz und 8 in einem anderen, und seine Start-Checkliste fordert immer noch auf, einen Newsletter-Endpunkt zu verdrahten, einen Mailto-Kaufbutton gegen Gumroad auszutauschen und ein OG-Bild zu generieren, die alle längst ausgeliefert wurden. Der schlimmste Treffer, den es erwischte, ist eine README-Zeile, die behauptet, die Testdaten seien Beispielmaterial, was durch 1320 pass / 715 setup / 290 queue / 108 fails-Urteile im Datensatz widerlegt wird. Es kennzeichnete auch eine verwaiste docs-internal-test-protocol.md – 56 Zeilen wichen vom Live-Protokoll ab, null eingehende Referenzen – die das Sicherheits-Gate weglässt und einem Agenten sagt, er solle Installationen bewerten, indem er Dateien abruft, anstatt sie auszuführen. Reines Markdown, keine Skripte, und der Diagnose-Durchlauf ließ den Arbeitsbaum wirklich unberührt.
Getestet am: 2026-08-10 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/aka-luan/doc-cleanup.git mkdir -p ~/.claude/skills cd doc-cleanup && cp -r skills/doc-cleanup ~/.claude/skills/doc-cleanup
Befehle & Beispiel-Prompts
/doc-cleanupZwei-Pass-Markdown-Rot-Audit: evidenzbasierte Diagnose, Bearbeitungen nur nach Genehmigung
Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):
Audit our docs folder for stale instructions and dead pathsCheck README.md for finished checklists still written as todosFind contradicting sources of truth across our markdown docs