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".

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: bash 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 | | …