SkillProof tested Claude skills

Doc Cleanup

To-pass Markdown rot-revisjon: evidensbasert diagnose, redigeringer kun ved godkjenning

av aka-luan · aka-luan/doc-cleanup

Bestått ★ 9.6/10

Doc Cleanup — To-pass Markdown rot-revisjon: evidensbasert diagnose, redigeringer kun ved godkjenning

Hva den gjør

Reviderer et repositoriums Markdown for kontekstforfall — ferdige sjekklister fortsatt skrevet som instruksjoner, leverte planer fortsatt skrevet som intensjon, utdaterte tellinger, døde stier og motstridende sannhetskilder — og krever repositoriumbevis for hvert funn før en løsning foreslås. Kjører diagnose-og-rapport først og stopper for godkjenning, deretter utfører den med en archive-and-rewrite playbook og en link/diff verification pass. Utløses av forespørsler om å gjennomgå, rydde eller faktasjekke prosjektdokumenter, CLAUDE.md eller AGENTS.md.

Testrapport

Pekte den mot et live Astro catalog repo's entry docs og docs/-mappe. Uten ferdigheten produserte jeg fire inntrykk ("numbers look stale", "there's a duplicate protocol file"); med den, tretten funn som hver overlevde en utført sjekk — README claims 64 skills where skills.json holds 2433, claims 12 categories in one paragraph and 8 in another, and its launch checklist still tells you to wire up a newsletter endpoint, swap a mailto buy button for Gumroad and generate an OG image that all shipped long ago. The single worst hit it caught is a README line asserting the test data is sample material, contradicted by 1320 pass / 715 setup / 290 queue / 108 fails verdicts in the dataset. It also flagged an orphan docs-internal-test-protocol.md — 56 lines diverged from the live protocol, zero inbound references — that omits the security gate and tells an agent to grade installs by fetching files instead of running them. Pure Markdown, no scripts, and the diagnostic pass genuinely left the worktree untouched.

Testet på: 2026-08-10 · Claude Code 2.x (agent harness)

Installer

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-revisjon: evidensbasert diagnose, redigeringer kun ved godkjenning

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen 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

Full rapport →