SkillProof tested Claude skills

Doc Cleanup

Audit di deterioramento Markdown in due passaggi: diagnosi basata su prove, modifiche solo su approvazione

di aka-luan · aka-luan/doc-cleanup

Promosso ★ 9.6/10

Doc Cleanup — Audit di deterioramento Markdown in due passaggi: diagnosi basata su prove, modifiche solo su approvazione

Cosa fa

Verifica il Markdown di un repository per il deterioramento del contesto — checklist completate ancora scritte come istruzioni, piani spediti ancora scritti come intenti, conteggi obsoleti, percorsi morti e fonti di verità contraddittorie — e richiede prove dal repository per ogni scoperta prima di proporre una correzione. Esegue prima diagnose-and-report e si ferma per l'approvazione, quindi esegue con un playbook archive-and-rewrite e un pass di verifica link/diff. Si attiva su richieste di revisionare, pulire o verificare i fatti dei documenti di progetto, CLAUDE.md o AGENTS.md.

Rapporto di test

L'ho puntato ai documenti di ingresso e alla cartella docs/ di un repo Astro catalog live. Senza la skill ho prodotto quattro impressioni ("numbers look stale", "there's a duplicate protocol file"); con essa, tredici scoperte che hanno superato ciascuna un controllo eseguito — README afferma 64 skills dove skills.json ne contiene 2433, afferma 12 categorie in un paragrafo e 8 in un altro, e la sua launch checklist ti dice ancora di wire up a newsletter endpoint, swap a mailto buy button for Gumroad e generate an OG image che sono stati tutti spediti molto tempo fa. Il singolo peggior problema che ha rilevato è una riga del README che afferma che i dati di test sono sample material, contraddetta dai verdetti 1320 pass / 715 setup / 290 queue / 108 fails nel dataset. Ha anche segnalato un orphan docs-internal-test-protocol.md — 56 righe divergevano dal protocollo live, zero inbound references — che omette il security gate e dice a un agente di grade installs by fetching files instead of running them. Pure Markdown, nessun script, e il pass diagnostico ha lasciato genuinamente il worktree intatto.

Testato il: 2026-08-10 · Claude Code 2.x (agent harness)

Installazione

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

Comandi e prompt di esempio

  • /doc-cleanupAudit di deterioramento Markdown in due passaggi: diagnosi basata su prove, modifiche solo su approvazione

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • 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

Rapporto completo →