audit-claude-md

Audit and refactor CLAUDE.md files to enforce context engineering best practices.

Updated Jan 5, 2026
One-click install
npx skills add https://github.com/Sjdjdiejdrirhdkjej/Claude-code-conductor --skill audit-claude-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-claude-md
Source: https://github.com/Sjdjdiejdrirhdkjej/Claude-code-conductor/tree/main/.claude/skills/audit-claude-md
Command: npx skills add https://github.com/Sjdjdiejdrirhdkjej/Claude-code-conductor --skill audit-claude-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit and refactor CLAUDE.md files to eliminate bloat, enforce context engineering best practices, and create folder-level CLAUDE.md files for complex domain-specific instructions.

Core Features & Use Cases

  • Line-count analysis across Feature CLAUDE.md, Project CLAUDE.md, and Root CLAUDE.md to enforce defined maximum lengths.
  • Vague language detection to replace non-committal phrasing with explicit directives.
  • Guidance for refactoring and organizing CLAUDE.md content into modular, folder-level instructions.

Quick Start

Run the audit command to analyze all CLAUDE.md files: /audit-claude-md Or audit a specific file: /audit-claude-md path/to/CLAUDE.md

Frequently Asked Questions about audit-claude-md

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

FAQPage Schema
How do I audit CLAUDE.md files for bloat and vague language?

To audit CLAUDE.md files, run the audit command to analyze line counts and detect vague language. This enforces context engineering best practices by replacing non-committal phrasing with explicit directives and removing unnecessary content.

What is context engineering for CLAUDE.md and when do I need to refactor?

Context engineering for CLAUDE.md involves enforcing concise files, explicit directives, and structured usage. You need to refactor when files exceed defined maximum line lengths or contain non-committal phrasing that bloats context.

Can I audit a specific CLAUDE.md file instead of all project files?

Yes, you can audit a specific CLAUDE.md file by providing its path as an argument to the audit command. This targets individual files for line-count analysis and vague-language detection without scanning the entire project.

How do I organize complex domain instructions in folder-level CLAUDE.md files?

You can organize complex domain instructions by refactoring root-level guidance into modular, folder-level CLAUDE.md files. This enforces structured usage where needed and keeps specialized context concise.

What are the line-count limits for Feature, Project, and Root CLAUDE.md files?

The audit enforces defined maximum line lengths across Feature, Project, and Root CLAUDE.md files. It analyzes these files to ensure they stay within limits, eliminating bloat and maintaining lean context.