claude-md-improver

Audit CLAUDE.md files across repositories and generate structured quality reports with proposed diffs.

2|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/roderik/mpe --skill claude-md-improver-roderik
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-md-improver
Source: https://github.com/roderik/mpe/tree/main/.agents/skills/claude-md-improver
Command: npx skills add https://github.com/roderik/mpe --skill claude-md-improver-roderik

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill audits CLAUDE.md files across a repository to ensure Claude Code has accurate project context and high-quality documentation.

Core Features & Use Cases

  • Quality assessment: evaluates CLAUDE.md against established templates and criteria.
  • Targeted updates: proposes minimal, actionable diffs to CLAUDE.md with user approval.
  • Workflow guidance: supports discovery, evaluation, reporting, and patch application across multi-project workspaces.

Quick Start

Run the improver against your repository to generate a quality report and propose targeted CLAUDE.md updates. Await user confirmation before applying changes.

Frequently Asked Questions about claude-md-improver

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit CLAUDE.md files across a monorepo?

To audit CLAUDE.md files across a monorepo, the Skill discovers and evaluates all instances against established templates to produce a structured quality report. It assesses documentation quality across package roots to ensure accurate project context.

What is the best way to improve CLAUDE.md documentation quality?

The best way to improve CLAUDE.md documentation quality is through a phase-based workflow of discovery, quality assessment, and reporting. This process evaluates files against criteria and proposes minimal, actionable diffs with user confirmation.

Can I generate actionable diffs for CLAUDE.md updates?

Yes, you can generate actionable diffs for CLAUDE.md updates. The Skill proposes targeted patch guidance and minimal diffs that follow update guidelines and maintain alignment with templates, awaiting your confirmation before applying changes.

Does the CLAUDE.md audit work with multi-project workspaces?

Yes, the CLAUDE.md audit works with multi-project workspaces. The workflow supports discovery, evaluation, reporting, and patch application across monorepos and package roots to maintain documentation alignment.

How do CLAUDE.md quality assessments evaluate repository context?

CLAUDE.md quality assessments evaluate repository context by checking documentation against established criteria and templates. This ensures Claude Code has accurate project context by identifying gaps and proposing targeted updates.

Why do I need user confirmation before applying CLAUDE.md patches?

You need user confirmation before applying CLAUDE.md patches to ensure proposed minimal diffs and update guidelines are reviewed. This targeted update phase prevents unwanted changes by requiring explicit approval before modifying documentation.