claude-md-improver

Audit and improve CLAUDE.md files in repositories. Use when user asks to check, audit, update, improve, or fix CLAUDE.md files. Scans for all CLAUDE.md files, evaluates quality against templates, outputs quality report, then makes targeted updates. Also use when the user mentions "CLAUDE.md maintenance" or "project memory optimization".

18,547stars2,256forksUpdated 5/5/2026

Code Review Documentation #bash #monorepo #documentation #claude-ai #code-review #project-management

Security Assessment

Safe(100/100)

Security Score100/100

About claude-md-improver

The claude-md-improver skill is designed to audit, evaluate, and improve CLAUDE.md files within a codebase, ensuring that project context is accurate, actionable, and up-to-date. CLAUDE.md files serve as a central repository of project knowledge for the Claude AI assistant, and maintaining their quality is critical for effective automation and code understanding. This skill addresses the common problem of outdated, incomplete, or inconsistent documentation by systematically scanning repositories, assessing file quality, and suggesting or applying targeted improvements.

FAQ

How does claude-md-improver identify CLAUDE.md files?

It searches the repository for files named CLAUDE.md, .claude.md, or .claude.local.md, including in package subdirectories and nested locations, up to 50 files by default. It also recognizes user-wide defaults in ~/.claude/CLAUDE.md.

Can this skill modify CLAUDE.md files directly?

Yes, but it only makes changes after generating a quality report and receiving explicit user confirmation. Updates are targeted, minimal, and focused on adding genuinely useful information without restating obvious content.

Which quality criteria are used for assessment?

Each CLAUDE.md file is evaluated on commands/workflows, architecture clarity, non-obvious patterns, conciseness, currency, and actionability. Files are scored from A (excellent) to F (severely outdated) based on these criteria.

Is claude-md-improver suitable for monorepos?

Yes, it automatically discovers CLAUDE.md files in parent directories and package-specific locations, making it effective for both single-project repositories and monorepo setups.

Are there any limitations or requirements?

The skill relies on standard command-line tools like find, grep, and bash for discovery and assessment. It only updates CLAUDE.md files that exist and does not invent new files or templates beyond targeted improvements.