skills.rest
josephneumann
josephneumannCOMMUNITY
Explore all skills by this author →
GitHub

claudemd-audit

Audit CLAUDE.md files for bloat, staleness, misplacement, and architectural issues.

4|Updated Jan 7, 2026
Search Tags:#code quality#documentation#audit#maintenance#ai context#claude.md
One-click install
npx skills add https://github.com/josephneumann/claude-corps --skill claudemd-audit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claudemd-audit
Source: https://github.com/josephneumann/claude-corps/tree/main/skills/claudemd-audit
Command: npx skills add https://github.com/josephneumann/claude-corps --skill claudemd-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps maintain the efficiency and clarity of your CLAUDE.md files by identifying and rectifying issues like excessive length, outdated information, or poor organization.

Core Features & Use Cases

  • Bloat Detection: Identifies overly long or redundant instructions within CLAUDE.md files.
  • Staleness Checks: Flags references to commands or files that no longer exist.
  • Structural Audits: Assesses if instructions are correctly placed (e.g., should be a hook, a skill, or in documentation).
  • Use Case: Before a major release, run this skill to ensure your project's CLAUDE.md is lean, accurate, and effectively guides the AI.

Quick Start

Run the claudemd-audit skill with the --all and --fix flags to audit all CLAUDE.md files and apply automatic corrections.

Frequently Asked Questions about claudemd-audit

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

FAQPage Schema
How do I audit a CLAUDE.md file for bloat and outdated references?▼

Run the claudemd-audit skill to analyze content length, verify command existence, and check import references for bloat and staleness across project, global, and all CLAUDE.md file scopes.

What is the best way to fix architectural misplacement in CLAUDE.md instructions?▼

Run the audit with the --fix flag to auto-remediate structural misplacement, identifying instructions in CLAUDE.md that should be relocated to hooks, skills, or external documentation.

Can I check all CLAUDE.md scopes globally for stale instructions at once?▼

Yes, run the audit with the --all flag to scan project, global, and all CLAUDE.md scopes simultaneously, detecting staleness, bloat, and structural issues across every file.

Why does my CLAUDE.md context seem ineffective and overly long for AI processing?▼

Your CLAUDE.md may suffer from bloat and redundant instructions; auditing detects excessive length and flags outdated references to ensure the file remains lean and effective for AI context.

Does the CLAUDE.md audit support automatic remediation for detected issues?▼

Yes, the audit supports automatic remediation via the --fix flag, which corrects detected bloat, staleness, and architectural misplacement issues across all analyzed CLAUDE.md scopes.

Related Skills

Explore More Software Engineering Skills→
robbytrobbyt
42

condense

Deduplicate and consolidate CLAUDE.md memory files across project hierarchies.

Community
Advanced
RoxabiRoxabi
9

cleanup-context

Audit AI context files and resolve contradictions, staleness, redundancy, and bloat.

Official
Advanced
xiaoyuge886xiaoyuge886
196

claude-md-improver

Audit CLAUDE.md files against quality rubrics and propose targeted updates.

Community
Intermediate
RooseveltAdvisorsRooseveltAdvisors
1

ContextArchitect

Audits WebSocket and HTTP APIs for vulnerabilities and then builds a proof-of-concept exploit.

Community
Intermediate