Doc Cleanup
Dvoufázový audit zastaralosti Markdownu: diagnóza podložená důkazy, úpravy pouze po schválení
Otestováno · Funguje
Co umí
Audituje Markdown repozitáře na zastaralost kontextu – dokončené kontrolní seznamy stále napsané jako instrukce, dodané plány stále napsané jako záměr, zastaralé počty, mrtvé cesty a protichůdné zdroje pravdy – a vyžaduje důkazy z repozitáře pro každé zjištění před navržením opravy. Nejprve spustí diagnose-and-report a zastaví se pro schválení, poté provede s archive-and-rewrite playbookem a link/diff ověřovacím průchodem. Spouští se na požadavky na kontrolu, čištění nebo ověření faktů v projektové dokumentaci, CLAUDE.md nebo AGENTS.md.
Testovací report
Nasměroval jsem ji na vstupní dokumentaci a složku docs/ živého repozitáře Astro katalogu. Bez dovednosti jsem vytvořil čtyři dojmy ("čísla vypadají zastarale", "existuje duplicitní soubor protokolu"); s ní třináct zjištění, z nichž každé přežilo provedenou kontrolu — README tvrdí 64 dovedností, kde skills.json obsahuje 2433, tvrdí 12 kategorií v jednom odstavci a 8 v jiném, a jeho spouštěcí kontrolní seznam vám stále říká, abyste zapojili newsletter endpoint, vyměnili mailto buy button za Gumroad a vygenerovali OG image, které byly všechny dodány dávno. Nejhorší jednotlivý zásah, který zachytila, je řádek README tvrdící, že testovací data jsou vzorový materiál, což je v rozporu s verdikty 1320 pass / 715 setup / 290 queue / 108 fails v datové sadě. Také označila osamocený docs-internal-test-protocol.md – 56 řádků se odchýlilo od živého protokolu, nulové příchozí reference – který vynechává bezpečnostní bránu a říká agentovi, aby hodnotil instalace stahováním souborů namísto jejich spouštění. Čistý Markdown, žádné skripty a diagnostický průchod skutečně nechal pracovní strom nedotčený.
Testováno: 2026-08-10 · Claude Code 2.x (agent harness)
Instalace
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
Příkazy a ukázkové prompty
/doc-cleanupDvoufázový audit zastaralosti Markdownu: diagnóza podložená důkazy, úpravy pouze po schválení
Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):
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