← Explore all skills

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.

Upstream setup instructions ↗
  1. The root README says to run `/plugin install {plugin-name}@claude-plugins-official`. The braces are a placeholder, so install.command is null.
  2. The claude-md-management README does not contain an install command.
  3. 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.

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

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

  3. https://github.com/anthropics/claude-plugins-official/blob/41f32e407b450055044f167db7ded5e8ff67d203/plugins/claude-md-management/LICENSE

    Supports: Apache License, Version 2.0

  4. Repository README ↗Checked

    https://github.com/anthropics/claude-plugins-official/blob/41f32e407b450055044f167db7ded5e8ff67d203/README.md

    Supports: placeholder install line

  5. Repository LICENSE ↗Checked

    https://github.com/anthropics/claude-plugins-official/blob/41f32e407b450055044f167db7ded5e8ff67d203/LICENSE

    Supports: Apache License, Version 2.0

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

Evidence & Ask