Claude MD Enhancer

Genereert en controleert CLAUDE.md bestanden tegen een vaste sectiechecklist en kwaliteitsscore

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

Getest · Werkt ★ 8.0/10

Claude MD Enhancer — Genereert en controleert CLAUDE.md bestanden tegen een vaste sectiechecklist en kwaliteitsscore

Wat het doet

Genereert nieuwe CLAUDE.md bestanden voor een repository en controleert bestaande bestanden tegen een vaste sectiechecklist (Overview, Project Structure, File Structure, Architecture, Setup, Tech Stack, Workflow, Commands). Levert Python modules die een CLAUDE.md parsen, ontbrekende secties opsommen, en een 0-100 kwaliteitsscore berekenen met gerangschikte aanbevelingen. Activeert wanneer je Claude vraagt om een CLAUDE.md te creëren, te herstructureren of te beoordelen, of om projectrichtlijnen op te splitsen in bestanden per directory.

Testrapport

GitHub API was rate-limited, dus ik kloonde de repo en vond SKILL.md op generated-skills/claude-md-enhancer/; frontmatter heeft name+description, elk in de body gerefereerd bestand bestaat (analyzer.py, generator.py, workflow.py allemaal HTTP 200 op raw, examples/ bevat de 6 referentiebestanden die het claimt), geen hardcoded paden, en de security grep vond alleen de eigen secret-detection regex van de validator. Ik bouwde een fixture repo (Fastify+Postgres invoicing API: package.json, src/routes/, migrations/, tests/, CI workflow), schreef een BASELINE CLAUDE.md op mijn normale manier (42 regels: What this is / Commands / Layout / Conventions / Notes), daarna een SKILL artefact volgens de Critical Validation Rule en Core template van de body (133 regels, toevoeging van Overview, een Project Structure ASCII tree, File Structure, Architecture met het request-flow pad, Setup & Installation, versioned Tech Stack, Testing Requirements en Error Handling). Het draaien van de eigen analyzer.py van de skill over beide scoorde de baseline 35/100 met "Missing critical sections: Core Principles, Tech Stack, Workflow" en het skill artefact 69/100 — de checklist dwong me echt om een Architecture sectie en een directory tree te schrijven die ik niet ongevraagd zou hebben geschreven, hoewel ~15 regels van de skill-versie opvulling zijn (kwartaaloverzicht notitie, footer metadata). Docs verliezen punten voor de onverifieerbare "100% Native Format Compliance ... matching /update-claude-md" claim en een interne inconsistentie: RECOMMENDED_SECTIONS van analyzer.py eiste nog steeds "Quick Navigation" en "Workflow Instructions" van een bestand dat de eigen sectielijst van de body volgde.

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

Installatie

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.

Commando's en voorbeeldprompts

/claude-md-enhancerGenereert en controleert CLAUDE.md bestanden tegen een vaste sectiechecklist en kwaliteitsscore

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

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

Volledig rapport (Engels) →