Claude MD Enhancer

Genererer og reviderer CLAUDE.md-filer mod en fast sektionscheckliste og kvalitetsscore

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

Testet · Virker ★ 8.0/10

Claude MD Enhancer — Genererer og reviderer CLAUDE.md-filer mod en fast sektionscheckliste og kvalitetsscore

Hvad det gør

Genererer nye CLAUDE.md-filer for et repository og reviderer eksisterende mod en fast sektionscheckliste (Overview, Project Structure, File Structure, Architecture, Setup, Tech Stack, Workflow, Commands). Leverer Python-moduler, der parser en CLAUDE.md, lister manglende sektioner og beregner en 0-100 kvalitetsscore med rangerede anbefalinger. Udløses, når du beder Claude om at oprette, omstrukturere eller gennemgå en CLAUDE.md, eller om at opdele projektretningslinjer i filer per mappe.

Testrapport

GitHub API var rate-begrænset, så jeg klonede repoet og fandt SKILL.md på generated-skills/claude-md-enhancer/; frontmatter har name+description, hver body-refererede fil eksisterer (analyzer.py, generator.py, workflow.py alle HTTP 200 på rå, examples/ indeholder de 6 referencefiler, den hævder), ingen hardkodede stier, og sikkerheds-grep'en fandt kun validatorens egen hemmeligheds-detektions regex. Jeg byggede et fixture-repo (Fastify+Postgres fakturerings-API: package.json, src/routes/, migrations/, tests/, CI workflow), skrev en BASELINE CLAUDE.md på min normale måde (42 linjer: What this is / Commands / Layout / Conventions / Notes), derefter et SKILL-artefakt efter body'ens Critical Validation Rule og Core template (133 linjer, der tilføjede Overview, et Project Structure ASCII-træ, File Structure, Architecture med request-flow-stien, Setup & Installation, versioneret Tech Stack, Testing Requirements og Error Handling). Kørsel af skillens egen analyzer.py over begge scorede baselinen 35/100 med "Missing critical sections: Core Principles, Tech Stack, Workflow" og skill-artefaktet 69/100 — checklisten fik mig oprigtigt til at skrive en Architecture-sektion og et mappetræ, jeg ikke ville have skrevet uopfordret, selvom ~15 linjer af skill-versionen er fyld (kvartalsvis gennemgangsnotat, footer-metadata). Docs mister point for den uverificerbare "100% Native Format Compliance ... matching /update-claude-md"-påstand og en intern inkonsekvens: analyzer.py's RECOMMENDED_SECTIONS krævede stadig "Quick Navigation" og "Workflow Instructions" fra en fil, der fulgte body'ens egen sektionsliste.

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

Installation

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 mod en fast sektionscheckliste og kvalitetsscore

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen 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

Læs hele rapporten →