Claude MD Enhancer

Genererer og reviderer CLAUDE.md-filer mot en fast seksjonsjekkliste og kvalitetsscore

av alirezarezvani · alirezarezvani/claude-code-skill-factory

Bestått ★ 8.0/10

Claude MD Enhancer — Genererer og reviderer CLAUDE.md-filer mot en fast seksjonsjekkliste og kvalitetsscore

Hva den gjør

Genererer nye CLAUDE.md-filer for et repository og reviderer eksisterende mot en fast seksjonsjekkliste (Overview, Project Structure, File Structure, Architecture, Setup, Tech Stack, Workflow, Commands). Leverer Python-moduler som parser en CLAUDE.md, lister manglende seksjoner, og beregner en 0-100 kvalitetsscore med rangerte anbefalinger. Utløses når du ber Claude om å opprette, restrukturere eller gjennomgå en CLAUDE.md, eller å splitte prosjektretningslinjer i filer per katalog.

Testrapport

GitHub API var rate-limited, så jeg klonet repoet og fant SKILL.md på generated-skills/claude-md-enhancer/; frontmatter har name+description, hver kroppsrefererte fil eksisterer (analyzer.py, generator.py, workflow.py alle HTTP 200 på rå, examples/ inneholder de 6 referansefilene den hevder), ingen hardkodede stier, og sikkerhets-grep fant bare validatorens egen hemmelighetsdeteksjons-regex. Jeg bygde et fixture-repo (Fastify+Postgres fakturerings-API: package.json, src/routes/, migrations/, tests/, CI workflow), skrev en BASELINE CLAUDE.md på min normale måte (42 linjer: What this is / Commands / Layout / Conventions / Notes), deretter en SKILL-artefakt etter kroppens Critical Validation Rule og Core-mal (133 linjer, la til Overview, et Project Structure ASCII-tre, File Structure, Architecture med forespørsel-flytstien, Setup & Installation, versjonert Tech Stack, Testing Requirements og Error Handling). Kjøring av ferdighetens egen analyzer.py over begge scoret baseline 35/100 med "Missing critical sections: Core Principles, Tech Stack, Workflow" og ferdighetsartefakten 69/100 — sjekklisten fikk meg genuint til å skrive en Architecture-seksjon og et katalogtre jeg ikke ville ha skrevet uoppfordret, selv om ~15 linjer av ferdighetsversjonen er fyllstoff (kvartalsvis gjennomgangsnotat, bunntekst metadata). Dokumentasjon mister poeng for den uverifiserbare "100% Native Format Compliance ... matching /update-claude-md" påstanden og en intern inkonsekvens: analyzer.py's RECOMMENDED_SECTIONS krevde fortsatt "Quick Navigation" og "Workflow Instructions" fra en fil som fulgte kroppens egen seksjonsliste.

Testet på: 2026-07-21 · Claude Code 2.x (agent harness)

Installer

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.

Kommandoer og eksempelprompter

/claude-md-enhancerGenererer og reviderer CLAUDE.md-filer mot en fast seksjonsjekkliste og kvalitetsscore

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

Generate a CLAUDE.md for this new project
Improve my existing CLAUDE.md file for this project
Add tech stack conventions to CLAUDE.md

Full rapport →