CLAUDE.MD MAINTENANCE / Anthropic
CLAUDE.md improver
Pins the CLAUDE.md skill that must print a quality report and wait for approval before it edits those files.
“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".”
01 / THE REASONING
Why this made the selection.
- The skill says it can write CLAUDE.md files only after it presents a quality report and the user approves.
- It says to output that report before any update, then show the specific addition, and only then apply it with the Edit tool.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- plugins/claude-md-management/skills/claude-md-improver/SKILL.md
- plugins/claude-md-management/README.md
- plugins/claude-md-management/LICENSE
- README.md
- LICENSE
Our findings
- The skill can write CLAUDE.md files, and it says to do that only after a quality report and user approval.
- The report is required before any update, and the next phase asks for confirmation before updating.
- Approved changes use the Edit tool and are supposed to preserve the existing structure.
- Updates are targeted additions. The file says not to restate what is obvious from the code.
- The discovery command stops after fifty paths. Declared tools are Read, Glob, Grep, Bash, and Edit.
Not established by this review
- The resource was not executed and its tools were not called.
- No CLAUDE.md file was found, scored, or edited.
- references/quality-criteria.md, references/templates.md, references/update-guidelines.md, and commands/revise-claude-md.md were not opened.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
- The root README says to run `/plugin install {plugin-name}@claude-plugins-official`. The braces are a placeholder, so install.command is null.
- The claude-md-management README does not contain an install command.
- The skill says to apply approved edits with the Edit tool. This review did not edit a CLAUDE.md file.
Before you start
- Claude Code
- A repository whose CLAUDE.md files the operator is willing to change only after approving a report
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/anthropics/claude-plugins-official/blob/41f32e407b450055044f167db7ded5e8ff67d203/plugins/claude-md-management/skills/claude-md-improver/SKILL.md
Supports: report-before-edit, confirmation, and the fifty-path discovery command
https://github.com/anthropics/claude-plugins-official/blob/41f32e407b450055044f167db7ded5e8ff67d203/plugins/claude-md-management/README.md
Supports: the sibling /revise-claude-md command, which was not opened
https://github.com/anthropics/claude-plugins-official/blob/41f32e407b450055044f167db7ded5e8ff67d203/plugins/claude-md-management/LICENSE
Supports: Apache License, Version 2.0
- Repository README ↗Checked
https://github.com/anthropics/claude-plugins-official/blob/41f32e407b450055044f167db7ded5e8ff67d203/README.md
Supports: placeholder install line
- Repository LICENSE ↗Checked
https://github.com/anthropics/claude-plugins-official/blob/41f32e407b450055044f167db7ded5e8ff67d203/LICENSE
Supports: Apache License, Version 2.0
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/claude-md-management/skills/claude-md-improver/SKILL.md
Supports: upstreamDescription, review.notTested, review.reviewedAt