Skip to main content

docs-health

Audit documentation health — file sizes, nested CLAUDE.md coverage, stale references, skill inventory. Triggers on doc audit, check docs, missing CLAUDE.md, bloated files, documentation drift, stale file references, skill line counts. Use when this capability is needed.

Ir a la instalación

Datos de origen

Repositorio
tomevault-io/skills-registry
Última actividad en el origen
28 de abril de 2026 a las 22:53
Idioma detectado de SKILL.md
inglés
Estrellas
0
Forks
0

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

Explorador de archivos
2 archivos

Mostrando SKILL.md

SKILL.md
Instrucciones de origen · Vista previa de solo lectura
name
docs-health
description
Audit documentation health — file sizes, nested CLAUDE.md coverage, stale references, skill inventory. Triggers on doc audit, check docs, missing CLAUDE.md, bloated files, documentation drift, stale file references, skill line counts. Use when this capability is needed.
metadata
{"author":"air-gapped"}
# Documentation Health Check ## Root CLAUDE.md !`wc -l < CLAUDE.md | xargs -I{} echo "Lines: {}"` !`wc -c < CLAUDE.md | xargs -I{} echo "Bytes: {}"` ## Nested CLAUDE.md files !`find internal/ -name CLAUDE.md -exec wc -l {} + 2>/dev/null || echo "None found"` ## Missing CLAUDE.md (directories with 5+ source files but no CLAUDE.md) !`for dir in internal/*/; do count=$(find "$dir" -maxdepth 1 -name '*.go' ! -name '*_test.go' 2>/dev/null | wc -l); if [ "$count" -ge 5 ] && [ ! -f "$dir/CLAUDE.md" ]; then echo "MISSING: $dir ($count source files)"; fi; done` ## Skills (lines per SKILL.md) !`wc -l .claude/skills/*/SKILL.md 2>/dev/null` ## Stale file references in nested CLAUDE.md !`find internal/ -name CLAUDE.md 2>/dev/null | while read cmd; do dir=$(dirname "$cmd"); grep -oE '[a-z_]+\.go' "$cmd" 2>/dev/null | sort -u | while read f; do if [ ! -f "$dir/$f" ]; then echo "STALE: $cmd references $f (not found)"; fi; done; done` ## Guidelines - Root CLAUDE.md: keep under 500 lines - Nested CLAUDE.md: keep under 100 lines each - Skills: load on-demand, size less critical but prefer <150 lines with references/ - If "MISSING" appears above, create a CLAUDE.md for that directory - If "STALE" appears above, fix the reference or remove it --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/air-gapped) — claim your Tome and manage your conversions. <!-- tomevault:4.0:skill_md:2026-04-13 -->
Ver en GitHub