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.