Claude MD Enhancer

Generuje a audituje soubory CLAUDE.md proti pevnému kontrolnímu seznamu sekcí a skóre kvality

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

Otestováno · Funguje ★ 8.0/10

Claude MD Enhancer — Generuje a audituje soubory CLAUDE.md proti pevnému kontrolnímu seznamu sekcí a skóre kvality

Co umí

Generuje nové soubory CLAUDE.md pro repozitář a audituje stávající proti pevnému kontrolnímu seznamu sekcí (Overview, Project Structure, File Structure, Architecture, Setup, Tech Stack, Workflow, Commands). Dodává Python moduly, které parsují CLAUDE.md, vypisují chybějící sekce a počítají skóre kvality 0-100 s doporučeními seřazenými podle priority. Spouští se, když požádáte Claude o vytvoření, restrukturalizaci nebo revizi CLAUDE.md, nebo o rozdělení projektových pokynů do souborů pro jednotlivé adresáře.

Testovací report

GitHub API bylo omezeno rychlostí, takže jsem klonoval repozitář a našel SKILL.md v generated-skills/claude-md-enhancer/; frontmatter má name+description, každý soubor odkazovaný v těle existuje (analyzer.py, generator.py, workflow.py všechny HTTP 200 raw, examples/ obsahuje 6 referenčních souborů, které tvrdí), žádné pevně zakódované cesty a bezpečnostní grep odhalil pouze vlastní regex pro detekci tajemství validátoru. Vytvořil jsem fixture repozitář (Fastify+Postgres invoicing API: package.json, src/routes/, migrations/, tests/, CI workflow), napsal BASELINE CLAUDE.md svým obvyklým způsobem (42 řádků: Co to je / Příkazy / Rozvržení / Konvence / Poznámky), poté artefakt DOVEDNOSTI podle Critical Validation Rule a Core šablony těla (133 řádků, přidávající Overview, ASCII strom Project Structure, File Structure, Architecture s cestou toku požadavků, Setup & Installation, verzovaný Tech Stack, Testing Requirements a Error Handling). Spuštění vlastního analyzer.py dovednosti na obou ohodnotilo základní test 35/100 s „Chybějící kritické sekce: Core Principles, Tech Stack, Workflow“ a artefakt dovednosti 69/100 — kontrolní seznam mě skutečně přiměl napsat sekci Architektura a strom adresářů, které bych bez výzvy nenapsal, ačkoli ~15 řádků verze dovednosti je výplň (poznámka k čtvrtletní revizi, metadata zápatí). Dokumentace ztrácí body za neověřitelné tvrzení „100% Native Format Compliance ... matching /update-claude-md“ a interní nekonzistenci: RECOMMENDED_SECTIONS analyzer.py stále vyžadovaly „Quick Navigation“ a „Workflow Instructions“ ze souboru, který následoval vlastní seznam sekcí těla.

Testováno: 2026-07-21 · Claude Code 2.x (agent harness)

Instalace

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.

Příkazy a ukázkové prompty

/claude-md-enhancerGeneruje a audituje soubory CLAUDE.md proti pevnému kontrolnímu seznamu sekcí a skóre kvality

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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

Kompletní testovací report (anglicky) →