claude-md-improver

Audit CLAUDE.md files and propose diff-based improvements with user approval.

6|1|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/mgajewskik/opencode-config --skill claude-md-improver-mgajewskik
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-md-improver
Source: https://github.com/mgajewskik/opencode-config/tree/main/skills/claude-md-improver
Command: npx skills add https://github.com/mgajewskik/opencode-config --skill claude-md-improver-mgajewskik

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

CLAUDE.md governance and maintenance across repositories is inconsistent; this skill audits and improves CLAUDE.md files to align them to templates and quality criteria.

Core Features & Use Cases

  • Quality assessment: scans all CLAUDE.md files and evaluates against standardized criteria (commands, architecture, gotchas, currency, actionability).
  • Targeted updates: proposes precise improvements and diffs for CLAUDE.md files, with user confirmation required before applying changes.
  • Workflow guidance: references best-practice templates and guidelines to standardize CLAUDE.md across projects.

Quick Start

Request a CLAUDE.md quality report for this repository and approve 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 CLAUDE.md files for documentation quality and consistency?

To audit CLAUDE.md files, scan all instances across your codebase to evaluate documentation quality, consistency, and actionable guidance against standardized criteria like commands, architecture, and gotchas, then generate a structured quality report.

What is the best way to standardize CLAUDE.md across a monorepo?

Standardizing CLAUDE.md across a monorepo involves evaluating all file instances against best-practice templates and quality criteria, then proposing targeted, diff-based updates with user confirmation to ensure standardized governance and maintainability.

What criteria should a CLAUDE.md quality assessment evaluate?

A CLAUDE.md quality assessment evaluates files against standardized criteria including commands, architecture descriptions, gotchas, documentation currency, and actionability to ensure the content provides effective, maintainable project guidance.

Does the CLAUDE.md improvement process require manual review before applying changes?

Yes, the CLAUDE.md improvement process requires manual review. It generates diff-based updates and structured quality reports, but all proposed changes must receive explicit user approval before being safely applied to the repository.

How do I generate a quality report for CLAUDE.md files in my repository?

Generate a CLAUDE.md quality report by scanning your repository to evaluate all file instances against standardized assessment criteria. The process produces a structured report highlighting documentation gaps and proposing targeted improvements.

Why does CLAUDE.md governance become inconsistent across multiple repositories?

CLAUDE.md governance becomes inconsistent across repositories due to varying maintenance practices and lack of standardized templates. Auditing and aligning files to quality criteria resolves these inconsistencies and ensures maintainable project documentation.