SkillProof tested Claude skills

Doc Cleanup

To-pass Markdown rot revision: evidensbaseret diagnose, redigeringer kun efter godkendelse

Af aka-luan · aka-luan/doc-cleanup

Testet · Virker ★ 9.6/10

Doc Cleanup — To-pass Markdown rot revision: evidensbaseret diagnose, redigeringer kun efter godkendelse

Hvad det gør

Reviderer et repositories Markdown for kontekstforfald — færdige tjeklister stadig skrevet som instruktioner, afsendte planer stadig skrevet som hensigt, forældede tællinger, døde stier og modstridende sandhedskilder — og kræver repository-evidens for hvert fund, før en løsning foreslås. Kører diagnose-og-rapport først og stopper for godkendelse, derefter udføres med en arkiv-og-overskrivnings-playbook og en link/diff-verifikationspass. Udløses af anmodninger om at gennemgå, rydde op i eller faktatjekke projektdokumenter, CLAUDE.md eller AGENTS.md.

Testrapport

Pegede den mod en live Astro katalog repos entry docs og docs/-mappe. Uden skillen producerede jeg fire indtryk ("tal ser forældede ud", "der er en duplikeret protokolfil"); med den, tretten fund, der hver overlevede en udført kontrol — README hævder 64 skills, hvor skills.json indeholder 2433, hævder 12 kategorier i ét afsnit og 8 i et andet, og dens lanceringscheckliste fortæller dig stadig at opsætte et nyhedsbrevs-endpoint, udskifte en mailto købsknap med Gumroad og generere et OG-billede, der alt sammen blev sendt for længe siden. Det enkelt værste hit, den fangede, er en README-linje, der hævder, at testdata er prøvemateriale, modsagt af 1320 pass / 715 setup / 290 queue / 108 fails domme i datasættet. Den markerede også en forældreløs docs-internal-test-protocol.md — 56 linjer afveg fra den live protokol, nul indgående referencer — der udelader sikkerhedsporten og fortæller en agent at bedømme installationer ved at hente filer i stedet for at køre dem. Ren Markdown, ingen scripts, og den diagnostiske pass efterlod ægte arbejdsmappen uberørt.

Testet: 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

Kommandoer og eksempelprompter

  • /doc-cleanupTo-pass Markdown rot revision: evidensbaseret diagnose, redigeringer kun efter godkendelse

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

  • Audit our docs folder for stale instructions and dead paths
  • Check README.md for finished checklists still written as todos
  • Find contradicting sources of truth across our markdown docs

Læs hele rapporten →