SkillProof tested Claude skills

Doc Cleanup

Audit de pourriture Markdown en deux passes : diagnostic basé sur des preuves, modifications uniquement sur approbation

par aka-luan · aka-luan/doc-cleanup

Testé · Fonctionne ★ 9.6/10

Doc Cleanup — Audit de pourriture Markdown en deux passes : diagnostic basé sur des preuves, modifications uniquement sur approbation

Ce que fait

Audite le Markdown d'un dépôt pour la pourriture contextuelle — listes de contrôle terminées toujours écrites comme des instructions, plans livrés toujours écrits comme une intention, comptes obsolètes, chemins morts et sources de vérité contradictoires — et exige des preuves du dépôt pour chaque constatation avant de proposer une correction. Exécute d'abord un diagnostic et un rapport, puis s'arrête pour approbation, puis exécute avec un playbook d'archivage et de réécriture et une passe de vérification de liens/diff. Se déclenche sur les demandes de révision, de nettoyage ou de vérification des faits des docs de projet, CLAUDE.md ou AGENTS.md.

Rapport de test

Je l'ai pointé vers les docs d'entrée et le dossier docs/ d'un dépôt de catalogue Astro en direct. Sans la skill, j'ai produit quatre impressions ('les chiffres semblent obsolètes', 'il y a un fichier de protocole en double') ; avec elle, treize constatations qui ont toutes survécu à une vérification exécutée — README affirme 64 skills là où skills.json en contient 2433, affirme 12 catégories dans un paragraphe et 8 dans un autre, et sa checklist de lancement vous dit toujours de câbler un endpoint de newsletter, d'échanger un bouton d'achat mailto contre Gumroad et de générer une image OG qui ont tous été livrés il y a longtemps. Le pire coup qu'il a détecté est une ligne du README affirmant que les données de test sont du matériel d'échantillon, contredite par 1320 pass / 715 setup / 290 queue / 108 fails verdicts dans le dataset. Il a également signalé un docs-internal-test-protocol.md orphelin — 56 lignes divergentes du protocole en direct, zéro référence entrante — qui omet la porte de sécurité et dit à un agent de noter les installations en récupérant des fichiers au lieu de les exécuter. Markdown pur, pas de scripts, et la passe de diagnostic a réellement laissé le worktree intact.

Testé le: 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

Commandes et exemples de prompts

  • /doc-cleanupAudit de pourriture Markdown en deux passes : diagnostic basé sur des preuves, modifications uniquement sur approbation

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • 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

Rapport complet →