SkillProof tested Claude skills

Doc Cleanup

Två-pass Markdown-förfallsrevision: evidensbaserad diagnos, redigeringar endast vid godkännande

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

Testad · Fungerar ★ 9.6/10

Doc Cleanup — Två-pass Markdown-förfallsrevision: evidensbaserad diagnos, redigeringar endast vid godkännande

Vad den gör

Granskar ett repos Markdown för kontextförfall — färdiga checklistor som fortfarande är skrivna som instruktioner, levererade planer som fortfarande är skrivna som avsikt, inaktuella räkningar, döda sökvägar och motsägande källor till sanning — och kräver repo-bevis för varje fynd innan ett förslag till fix. Kör diagnose-and-report först och stannar för godkännande, sedan exekverar med en archive-and-rewrite playbook och ett länk/diff-verifieringspass. Utlöses av förfrågningar om att granska, rensa eller faktakontrollera projektets docs, CLAUDE.md eller AGENTS.md.

Testrapport

Pekade den mot ett live Astro katalogrepos entry docs och docs/ mapp. Utan färdigheten producerade jag fyra intryck ("siffror ser inaktuella ut", "det finns en dubblettprotokollfil"); med den, tretton fynd som var och en överlevde en utförd kontroll — README hävdar 64 färdigheter där skills.json innehåller 2433, hävdar 12 kategorier i ett stycke och 8 i ett annat, och dess lanseringschecklista säger fortfarande att du ska koppla upp en nyhetsbrevs-endpoint, byta ut en mailto köpknapp mot Gumroad och generera en OG-bild som alla levererades för länge sedan. Den värsta enskilda träffen den fångade är en README-rad som hävdar att testdata är exempelmaterial, motsagd av 1320 pass / 715 setup / 290 queue / 108 fails utslag i datasetet. Den flaggade också en föräldralös docs-internal-test-protocol.md — 56 rader avvek från det levande protokollet, noll inkommande referenser — som utelämnar säkerhetsgrinden och säger åt en agent att betygsätta installationer genom att hämta filer istället för att köra dem. Ren Markdown, inga skript, och diagnospasset lämnade verkligen arbetsytan orörd.

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

Kommandon och exempelprompter

  • /doc-cleanupTvå-pass Markdown-förfallsrevision: evidensbaserad diagnos, redigeringar endast vid godkännande

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

  • 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 hela rapporten →