Claude MD Enhancer
Genera y audita archivos CLAUDE.md contra una lista de verificación de secciones fija y una puntuación de calidad
Probado · Funciona
Qué hace
Genera nuevos archivos CLAUDE.md para un repositorio y audita los existentes contra una lista de verificación de secciones fija (Overview, Project Structure, File Structure, Architecture, Setup, Tech Stack, Workflow, Commands). Incluye módulos de Python que analizan un CLAUDE.md, listan las secciones faltantes y calculan una puntuación de calidad de 0 a 100 con recomendaciones clasificadas. Se activa cuando le pides a Claude que cree, reestructure o revise un CLAUDE.md, o que divida las directrices del proyecto en archivos por directorio.
Informe de la prueba
La API de GitHub tenía límite de tasa, así que cloné el repositorio y encontré SKILL.md en generated-skills/claude-md-enhancer/; el frontmatter tiene name+description, cada archivo referenciado en el cuerpo existe (analyzer.py, generator.py, workflow.py todos HTTP 200 en raw, examples/ contiene los 6 archivos de referencia que afirma), no hay rutas codificadas, y el grep de seguridad solo encontró la propia regex de detección de secretos del validador. Construí un repositorio de prueba (API de facturación Fastify+Postgres: package.json, src/routes/, migrations/, tests/, flujo de trabajo CI), escribí un CLAUDE.md de LÍNEA BASE a mi manera normal (42 líneas: Qué es esto / Comandos / Diseño / Convenciones / Notas), luego un artefacto de HABILIDAD siguiendo la Regla de Validación Crítica y la plantilla Core del cuerpo (133 líneas, añadiendo Overview, un árbol ASCII de Project Structure, File Structure, Architecture con la ruta del flujo de solicitud, Setup & Installation, Tech Stack versionado, Testing Requirements y Error Handling). Ejecutar el propio analyzer.py de la habilidad sobre ambos puntuó la línea base 35/100 con "Missing critical sections: Core Principles, Tech Stack, Workflow" y el artefacto de la habilidad 69/100 — la lista de verificación realmente me hizo escribir una sección de Arquitectura y un árbol de directorios que no habría escrito sin ser solicitado, aunque ~15 líneas de la versión de la habilidad son de relleno (nota de revisión trimestral, metadatos de pie de página). La documentación pierde puntos por la afirmación no verificable "100% Native Format Compliance ... matching /update-claude-md" y una inconsistencia interna: RECOMMENDED_SECTIONS de analyzer.py todavía exigía "Quick Navigation" y "Workflow Instructions" de un archivo que seguía la propia lista de secciones del cuerpo.
Probado el: 2026-07-21 · Claude Code 2.x (agent harness)
Instalación
git clone --depth 1 https://github.com/alirezarezvani/claude-code-skill-factory.git /tmp/claude-md-enhancer-src
mkdir -p ~/.claude/skills
cp -R /tmp/claude-md-enhancer-src/generated-skills/claude-md-enhancer ~/.claude/skills/claude-md-enhancer
# No dependencies beyond Python 3 (stdlib only) for the optional analyzer/validator modules.
# The five .py files (analyzer, validator, generator, template_selector, workflow) have no
# CLI entrypoint (no __main__ block) — they are importable modules, e.g.
# python3 -c "import sys;sys.path.insert(0,'$HOME/.claude/skills/claude-md-enhancer');
# from analyzer import CLAUDEMDAnalyzer;print(CLAUDEMDAnalyzer(open('CLAUDE.md').read()).analyze_file())"
# The repo is a multi-skill monorepo; only the claude-md-enhancer directory is needed. Comandos y prompts de ejemplo
/claude-md-enhancerGenera y audita archivos CLAUDE.md contra una lista de verificación de secciones fija y una puntuación de calidad
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
Generate a CLAUDE.md for this new projectImprove my existing CLAUDE.md file for this projectAdd tech stack conventions to CLAUDE.md