Claude MD Enhancer

Genererar och granskar CLAUDE.md-filer mot en fast sektionschecklista och kvalitetspoäng

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

Testad · Fungerar ★ 8.0/10

Claude MD Enhancer — Genererar och granskar CLAUDE.md-filer mot en fast sektionschecklista och kvalitetspoäng

Vad den gör

Genererar nya CLAUDE.md-filer för ett repository och granskar befintliga mot en fast sektionschecklista (Overview, Project Structure, File Structure, Architecture, Setup, Tech Stack, Workflow, Commands). Levereras med Python-moduler som parsas en CLAUDE.md, listar saknade sektioner och beräknar en kvalitetspoäng på 0-100 med rankade rekommendationer. Utlöses när du ber Claude att skapa, omstrukturera eller granska en CLAUDE.md, eller att dela upp projektriktlinjer i filer per katalog.

Testrapport

GitHub API var hastighetsbegränsad, så jag klonade repot och hittade SKILL.md på generated-skills/claude-md-enhancer/; frontmatter har name+description, varje kroppsrefererad fil existerar (analyzer.py, generator.py, workflow.py alla HTTP 200 rå, examples/ innehåller de 6 referensfiler den hävdar), inga hårdkodade sökvägar, och säkerhetsgreppen hittade endast validatorns egen regex för hemlighetsdetektering. Jag byggde ett fixture-repo (Fastify+Postgres fakturerings-API: package.json, src/routes/, migrations/, tests/, CI-arbetsflöde), skrev en BASLINJE CLAUDE.md på mitt vanliga sätt (42 rader: Vad detta är / Kommandon / Layout / Konventioner / Anteckningar), sedan en FÄRDIGHETS-artefakt som följde kroppens Critical Validation Rule och Core-mall (133 rader, lade till Overview, ett Project Structure ASCII-träd, File Structure, Architecture med request-flow-sökvägen, Setup & Installation, versionerad Tech Stack, Testing Requirements och Error Handling). Att köra färdighetens egen analyzer.py över båda gav baslinjen 35/100 med "Missing critical sections: Core Principles, Tech Stack, Workflow" och färdighetsartefakten 69/100 — checklistan fick mig verkligen att skriva en Architecture-sektion och ett katalogträd som jag inte skulle ha skrivit utan uppmaning, även om ~15 rader av färdighetsversionen är utfyllnad (kvartalsgranskningsanteckning, sidfotsmetadata). Dokumentation förlorar poäng för det overifierbara påståendet "100% Native Format Compliance ... matching /update-claude-md" och en intern inkonsekvens: analyzer.py:s RECOMMENDED_SECTIONS krävde fortfarande "Quick Navigation" och "Workflow Instructions" från en fil som följde kroppens egen sektionslista.

Testad: 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.

Kommandon och exempelprompter

/claude-md-enhancerGenererar och granskar CLAUDE.md-filer mot en fast sektionschecklista och kvalitetspoäng

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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 hela rapporten →