claude-md-improver

Audit CLAUDE.md files, evaluate quality against templates, and produce targeted updates.

10|2|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/mahmoud20138/Tradecraft --skill claude-md-improver-mahmoud20138
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-md-improver
Source: https://github.com/mahmoud20138/Tradecraft/tree/main/plugins/tradecraft/skills/claude-md-improver
Command: npx skills add https://github.com/mahmoud20138/Tradecraft --skill claude-md-improver-mahmoud20138

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CLAUDE.md Improver helps maintain high-quality CLAUDE.md context across a codebase by auditing CLAUDE.md files and updating them to align with templates and quality rubrics.

Core Features & Use Cases

  • Discover CLAUDE.md files in project roots, subdirectories, packages, and other configured locations.
  • Assess quality against established rubrics, generate a comprehensive report, and propose precise edits.
  • Apply project-specific templates to ensure consistency and up-to-date project context across repositories.

Quick Start

Run the audit workflow to identify CLAUDE.md files, generate a quality report, and propose targeted updates.

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 and improve CLAUDE.md files across my codebase?

To audit CLAUDE.md files, the Skill searches typical locations like project roots and nested directories, evaluates quality against templates, and generates a report with actionable recommendations and safe edits.

What is a CLAUDE.md quality audit and why do I need it?

A CLAUDE.md quality audit evaluates your context files against established rubrics to ensure consistency and up-to-date project context across repositories, preventing outdated or misaligned documentation.

Can I apply custom markdown templates to CLAUDE.md files in nested directories?

Yes, you can apply project-specific markdown templates to ensure consistency across all discovered files, including those in project roots, subdirectories, and package-level locations.

What's the best way to generate a quality report for repository markdown documentation?

The best way to generate a markdown quality report is running the audit workflow, which discovers files, evaluates them against rubrics, and proposes precise targeted updates with traceable change records.

Does the CLAUDE.md audit process make automatic changes to my repository?

The audit ensures safe edits by proposing targeted updates and recording changes for traceability, allowing you to review the quality report and recommendations before applying modifications.

How do CLAUDE.md audits handle multiple package-level files in one repository?

CLAUDE.md audits handle multiple files by searching typical locations including project root, package-level, and nested directories, evaluating each against templates and producing a comprehensive quality report.