Claude MD Enhancer
Genera e verifica file CLAUDE.md rispetto a una checklist di sezioni fissa e un punteggio di qualità.
Promosso
Cosa fa
Genera nuovi CLAUDE.md file per un repository e verifica quelli esistenti rispetto a una checklist di sezioni fissa (Overview, Project Structure, File Structure, Architecture, Setup, Tech Stack, Workflow, Commands). Fornisce moduli Python che analizzano un CLAUDE.md, elencano le sezioni mancanti e calcolano un punteggio di qualità da 0 a 100 con raccomandazioni classificate. Si attiva quando si chiede a Claude di creare, ristrutturare o revisionare un CLAUDE.md, o di suddividere le linee guida del progetto in file per directory.
Rapporto di test
L'API GitHub era limitata per rate, quindi ho clonato il repo e ho trovato SKILL.md in generated-skills/claude-md-enhancer/; il frontmatter ha name+description, ogni file referenziato nel corpo esiste (analyzer.py, generator.py, workflow.py tutti HTTP 200 in raw, examples/ contiene i 6 file di riferimento che dichiara), nessun percorso hardcoded, e il grep di sicurezza ha trovato solo la regex di rilevamento segreti del validatore stesso. Ho costruito un repo fixture (API di fatturazione Fastify+Postgres: package.json, src/routes/, migrations/, tests/, workflow CI), ho scritto un CLAUDE.md BASELINE nel mio modo normale (42 righe: What this is / Commands / Layout / Conventions / Notes), quindi un artefatto SKILL seguendo la Critical Validation Rule e il Core template del corpo (133 righe, aggiungendo Overview, un albero ASCII della Project Structure, File Structure, Architecture con il percorso del flusso di richiesta, Setup & Installation, Tech Stack versionato, Testing Requirements e Error Handling). L'esecuzione dell'analyzer.py della skill su entrambi ha assegnato alla baseline un punteggio di 35/100 con "Missing critical sections: Core Principles, Tech Stack, Workflow" e all'artefatto della skill 69/100 — la checklist mi ha genuinamente fatto scrivere una sezione Architecture e un albero di directory che non avrei scritto senza prompt, anche se ~15 righe della versione della skill sono riempitive (nota di revisione trimestrale, metadati del footer). La documentazione perde punti per l'affermazione non verificabile "100% Native Format Compliance ... matching /update-claude-md" e un'incoerenza interna: RECOMMENDED_SECTIONS di analyzer.py richiedeva ancora "Quick Navigation" e "Workflow Instructions" da un file che seguiva l'elenco di sezioni del corpo stesso.
Testato il: 2026-07-21 · Claude Code 2.x (agent harness)
Installazione
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. Comandi e prompt di esempio
/claude-md-enhancerGenera e verifica file CLAUDE.md rispetto a una checklist di sezioni fissa e un punteggio di qualità.
Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):
Generate a CLAUDE.md for this new projectImprove my existing CLAUDE.md file for this projectAdd tech stack conventions to CLAUDE.md