review-claudemd

Audit CLAUDE.md files for dead references, orphaned assets, and token bloat.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ItsMattG/property-tracker --skill review-claudemd-itsmattg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-claudemd
Source: https://github.com/ItsMattG/property-tracker/tree/main/.claude/skills/review-claudemd
Command: npx skills add https://github.com/ItsMattG/property-tracker --skill review-claudemd-itsmattg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill audits CLAUDE.md health across the repository to surface dead references, bloated rules, and inconsistencies that waste tokens and confuse users.

Core Features & Use Cases

  • Detect dead file references in CLAUDE.md files and .claude/rules/*.md
  • Identify orphaned skills, agents, or rules not referenced anywhere
  • Provide a concise health report with actionable remediation steps

Quick Start

Ask the system to run a CLAUDE.md health check and generate a report.

Frequently Asked Questions about review-claudemd

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

FAQPage Schema
How do I find dead references and orphaned assets in CLAUDE.md files?

To find dead references and orphaned assets in CLAUDE.md files, run a health audit that scans the .claude/skills and .claude/rules structure to validate cross-references and flag unreachable assets. This generates a concise health report with actionable remediation steps.

What is CLAUDE.md token bloat and how does an audit help?

CLAUDE.md token bloat occurs when markdown rules and configurations contain unnecessary or duplicated content. A health audit identifies bloated rules and inconsistencies, ensuring your markdown files satisfy size constraints and operate efficiently without wasting tokens.

How do I validate frontmatter and section checks in markdown rules?

You validate frontmatter presence and section checks by performing a CLAUDE.md health audit. This process examines your markdown rules to ensure consistency, verifying that required structural elements are present and properly formatted across the repository.

Can I check .claude/rules and .claude/skills directories for unreferenced files?

Yes, you can check .claude/rules and .claude/skills directories for unreferenced files. The audit identifies orphaned skills, agents, or rules that are not referenced anywhere within your CLAUDE.md files, providing actionable remediation steps.

What's the best way to generate a remediation report for inconsistent markdown configurations?

The best way to generate a remediation report for inconsistent markdown configurations is to run a CLAUDE.md health check. This audit surfaces dead references and bloated rules, outputting a concise health report with specific, actionable remediation steps.