claude-md-improver skill (Anthropic) for Claude Code: audit your CLAUDE.md files

claude-md-improver makes Claude audit your CLAUDE.md files, score them and propose small fixes you approve.

Installs: 13.4K; on skills.sh
Stars: 45.7K; on GitHub
Files: 3; besides SKILL.md
Updated: Nov 2026; last repo commit

claude-md-improver is a skill in Anthropic's claude-md-management plugin. Ask it to check, audit or improve your CLAUDE.md files. It finds every CLAUDE.md, .claude.md and .claude.local.md in the repository, scores each one out of 100 across six criteria, and prints a quality report before it changes anything.

After the report it shows each proposed addition as a diff with a reason, asks for your approval, and then edits the files. It runs a find command and uses Read, Glob, Grep, Bash and Edit tools. It bundles no scripts. It can write to CLAUDE.md files, so review each diff.

Good for

Developers whose CLAUDE.md has gone stale after the codebase changed
Teams keeping shared project memory concise and current
Monorepo owners with CLAUDE.md files in many packages

Install claude-md-improver

Claude Code

Copy this prompt.

Install the claude-md-improver skill in Claude Code. Run this command:

/plugin install claude-md-management@claude-plugins-official

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

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

Sections in SKILL.md

Workflow
Phase 1: Discovery
Phase 2: Quality Assessment
Phase 3: Quality Report Output
CLAUDE.md Quality Report
Summary
File-by-File Assessment
Phase 4: Targeted Updates
Update: ./CLAUDE.md
Phase 5: Apply Updates
Templates
Common Issues to Flag
User Tips to Share
What Makes a Great CLAUDE.md

Key facts

Author: anthropics (GitHub account that owns the repo)
Source repo: anthropics/claude-plugins-official
Installs on skills.sh: 13,422 as of 2026-11-02
GitHub stars: 45,717 (whole repo) as of 2026-11-02
License: Apache-2.0
Last repo commit: 2026-11-01
Files: 4 files including SKILL.md (references: quality-criteria, templates, update-guidelines)
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass
Part of: claude-md-management plugin (this skill and the /revise-claude-md command)
Allowed tools: Read, Glob, Grep, Bash, Edit

What it includes

Finds CLAUDE.md, .claude.md and .claude.local.md files with find, up to 50 results.
Runs code · Phase 1: Discovery
Scores each file on six criteria, from commands to actionability.
Read · Phase 2: Quality assessment
Always prints a report with scores, issues and recommended additions before any edit.
Phase 3: Quality report
Shows each proposed change as a diff with a reason and asks you to confirm.
Phase 4: Targeted updates
After approval, edits the files with the Edit tool and keeps existing structure.
Write · Phase 5: Apply updates
Reference files with CLAUDE.md templates by project type and rules for what to add.
Templates and guidelines
Plugin-only command that captures session learnings into CLAUDE.md after you approve.
This is a separate command in the same plugin, not part of the skill folder.
Write · /revise-claude-md (plugin command)

From the official docs

Permissions

Low risk

The skill reads your repo and can edit your CLAUDE.md files, but only after it shows a report and you approve each change. Review the diffs before saying yes.

What it can do

Read your data
Create and change things
Delete things
Read-only modeHow to turn it on

Watch out for

It edits CLAUDE.md files after approval
SKILL.md says the skill can write to CLAUDE.md files, using the Edit tool, once you approve. Check each diff, since CLAUDE.md shapes every later session. github.com
The plugin route adds a command
claude-md-management also contains /revise-claude-md, which can edit CLAUDE.md after approval. The plugin tree shows no hooks or MCP config. github.com
Marketplace trust warning
The claude-plugins-official README says Anthropic does not control what files or software are included in plugins and to trust a plugin before installing it. github.com

Technical details

Turning on read-only	SKILL.md prints the quality report first and asks before editing, so you can stop after the report.
Scopes	CLAUDE.md, .claude.md and .claude.local.md files in your repo

Questions

How do I install claude-md-improver?

In Claude Code, use the plugin route in the install box. It installs claude-md-management, which adds this skill and the /revise-claude-md command. The skills CLI command installs the skill alone.

Will it rewrite my CLAUDE.md without asking?

No. SKILL.md says to always output the quality report before making any updates, then ask for confirmation. It shows each change as a diff with a reason and applies edits only after you approve.

Which files does it look at?

CLAUDE.md, .claude.md and .claude.local.md files found by a find command in the repository, limited to 50 results. SKILL.md also lists the global ~/.claude/CLAUDE.md as a type of file, but the discovery command searches from the current folder.

How does it score a CLAUDE.md?

Out of 100 across six criteria: commands and workflows, architecture clarity, non-obvious patterns, conciseness, currency and actionability. Grades run from A (90 to 100) to F (0 to 29). The rubric is in references/quality-criteria.md.

claude-md-improver vs /revise-claude-md?

The plugin README says the skill keeps CLAUDE.md aligned with the codebase and suits periodic maintenance. The command captures learnings from the current session and suits the end of a session.

Is claude-md-improver safe to install?

It bundles no scripts. It runs a find command and edits CLAUDE.md files, but only after showing a report and getting your approval. The marketplace README warns you to trust a plugin before installing it.

Information

updated Nov 2, 2026

Repository: anthropics/claude-plugins-official
Folder: plugins/claude-md-management/skills/claude-md-improver

anthropics/claude-plugins-official skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 10

claude-plugins-official README · github.com
claude-md-management README · github.com
Claude Code skills · code.claude.com
Using skills in Claude · support.claude.com
claude-md-improver SKILL.md · github.com
claude-md-improver on skills.sh · skills.sh
templates.md · github.com
update-guidelines.md · github.com
quality-criteria.md · github.com
revise-claude-md command · github.com