claude-md-improver

Audit CLAUDE.md files and generate quality reports with staged updates.

1|Updated Jun 12, 2025
One-click install
npx skills add https://github.com/domenhribernik/portfolio --skill claude-md-improver-domenhribernik
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-md-improver
Source: https://github.com/domenhribernik/portfolio/tree/main/.agents/skills/claude-md-improver
Command: npx skills add https://github.com/domenhribernik/portfolio --skill claude-md-improver-domenhribernik

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill audits and improves CLAUDE.md files across a codebase to ensure clear project context and consistent documentation.

Core Features & Use Cases

  • Discovery: locate all CLAUDE.md files including root, package-specific, and monorepo contexts.
  • Quality assessment: evaluate CLAUDE.md files against defined quality rubrics and generate a structured quality report.
  • Targeted updates: propose and apply improvements after user approval, with change-diff guidance.

Quick Start

Provide a full CLAUDE.md quality assessment and suggested updates for this project.

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 in a codebase?

You can audit CLAUDE.md files by discovering all project contexts, assessing them against quality rubrics, generating a structured report, and applying staged diffs for targeted updates after user approval.

What is a CLAUDE.md quality assessment?

A CLAUDE.md quality assessment evaluates project context files against defined rubrics to ensure accurate documentation, generating a structured report that identifies areas for targeted improvement across monorepo and package-specific contexts.

Can I use this to audit documentation across a monorepo?

Yes, the CLAUDE.md audit supports monorepo contexts by discovering all root, package-specific, and nested project files, evaluating each against quality rubrics to ensure consistent documentation across the entire repository.

How do I generate a quality report for project documentation?

You generate a documentation quality report by running the audit process, which evaluates discovered CLAUDE.md files against defined rubrics and outputs a structured assessment of project context accuracy and completeness.

Does the CLAUDE.md update process require manual approval?

Yes, the update process requires user approval before applying any changes, proposing targeted improvements with change-diff guidance to ensure you maintain control over project context modifications.