Skip to content
Kitbay
Skill

claude-md-improver

Apache-2.0Updated on Nov 11, 202646,808GitHub stars

A skill in Anthropic's claude-md-management plugin for Claude Code that audits and improves a project's CLAUDE.md files.

What the skill teaches

A skill in Anthropic's claude-md-management plugin for Claude Code that audits and improves a project's CLAUDE.md files. The agent finds every such file, including local override and package-level ones, and scores each out of 100 on six weighted points: commands, architecture clarity, non-obvious patterns, brevity, being up to date and actionability, giving a grade from A to F. It must show the quality report before changing anything, then proposes additions as diffs with a reason for each, such as discovered commands, gotchas or setup quirks, and applies them only after the user approves. It advises against stating the obvious or adding generic advice, and points to reference files for the rubric and templates.

Capabilities

  • Find all CLAUDE.md files in a project
  • Score each file against a rubric
  • Propose additions as diffs
  • Apply approved updates