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".
Best for Project maintainersWorks with GitHub
⌘source
- author
@anthropics- language
- Python
★17kstars
2.1kforks
Apr 21, 2026
✦overview.md
Key Features
- ·Audits and improves CLAUDE.md files across a codebase
- ·Evaluates file quality against templates
- ·Generates a quality report for user review
- ·Makes targeted updates to files after approval
- ·Scans for multiple CLAUDE.md file types and locations
- ·Can write to CLAUDE.md files
Use Cases
- →Checking or auditing CLAUDE.md files for quality
- →Updating or fixing CLAUDE.md files across a project
- →Maintaining project memory and context documentation
- →Ensuring Claude Code has optimal project context
- →Managing CLAUDE.md files in monorepos with package-specific contexts
Best for
- ✓Project maintainers
- ✓Teams using Claude Code
- ✓Repository documentation audits
Not ideal for
- !Non-CLAUDE.md documentation
- !Projects without CLAUDE.md files
FAQs
name
claude-md-improver
description
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".
tools:Read, Glob, Grep, Bash, Edit
CLAUDE.md Improver
Audit, evaluate, and improve CLAUDE.md files across a codebase to ensure Claude Code has optimal project context.
This skill can write to CLAUDE.md files. After presenting a quality report and getting user approval, it updates CLAUDE.md files with targeted improvements.
Workflow
Phase 1: Discovery
Find all CLAUDE.md files in the repository:
find . -name "CLAUDE.md" -o -name ".claude.md" -o -name ".claude.local.md" 2>/dev/null | head -50
File Types & Locations:
| Type | Location | Purpose |
|---|---|---|
| Project root | ./CLAUDE.md | Primary project context (checked into git, shared with team) |
| Local overrides | ./.claude.local.md | Personal/local settings (gitignored, not shared) |
| Global defaults | ~/.claude/CLAUDE.md | User-wide defaults across all projects |
| Package-specific | ./packages/*/CLAUDE.md | Module-level context in monorepos |
| Subdirectory | Any nested location | Feature/domain-specific context |
Note: Claude auto-discovers CLAUDE.md files in parent directories, making monorepo setups work automatically.
Phase 2: Quality Assessment
$install
1-click copynpx skills add anthropics/claude-plugins-official --skill claude-md-improverSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.