SkillProof tested Claude skills

Doc Cleanup

Auditoría de deterioro de Markdown en dos pasadas: diagnóstico basado en evidencia, ediciones solo con aprobación

Por aka-luan · aka-luan/doc-cleanup

Probado · Funciona ★ 9.6/10

Doc Cleanup — Auditoría de deterioro de Markdown en dos pasadas: diagnóstico basado en evidencia, ediciones solo con aprobación

Qué hace

Audita el Markdown de un repositorio en busca de context rot — finished checklists still written as instructions, shipped plans still written as intent, stale counts, dead paths y contradicting sources of truth — y requires repository evidence para cada finding antes de proposing a fix. Runs diagnose-and-report first y stops for approval, then executes with an archive-and-rewrite playbook y un link/diff verification pass. Se activa con requests para review, clean o fact-check project docs, CLAUDE.md o AGENTS.md.

Informe de la prueba

Se apuntó a un live Astro catalog repo's entry docs y docs/ folder. Without the skill produje four impressions ("numbers look stale", "there's a duplicate protocol file"); con ella, thirteen findings que each survived an executed check — README claims 64 skills donde skills.json holds 2433, claims 12 categories en one paragraph y 8 en another, y su launch checklist still tells you to wire up a newsletter endpoint, swap a mailto buy button for Gumroad y generate an OG image que all shipped long ago. El single worst hit que caught es una README line asserting the test data is sample material, contradicted by 1320 pass / 715 setup / 290 queue / 108 fails verdicts en el dataset. It also flagged an orphan docs-internal-test-protocol.md — 56 lines diverged del live protocol, zero inbound references — que omits the security gate y tells an agent to grade installs by fetching files instead of running them. Pure Markdown, no scripts, y el diagnostic pass genuinely left the worktree untouched.

Probado el: 2026-08-10 · Claude Code 2.x (agent harness)

Instalación

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

Comandos y prompts de ejemplo

  • /doc-cleanupAuditoría de deterioro de Markdown en dos pasadas: diagnóstico basado en evidencia, ediciones solo con aprobación

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • 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

Informe completo →