claude-audit

Installation
SKILL.md

Claude Audit Skill

Analyze all .claude/ configuration files to find optimization opportunities.

Workflow

  1. Scan files: Find all .md files in .claude/ directory (rules/, commands/, agents/, skills/)
  2. Analyze each file for:
    • Redundant instructions: Rules that repeat across multiple files
    • Verbose phrasing: Overly wordy explanations that can be concise
    • Move to memory candidates: Content rarely needed in context but referenced
  3. Present findings in a structured format
  4. Ask user: Which optimizations to implement?

Analysis Criteria

Redundant Instructions

  • Same rule mentioned in multiple files
  • Overlapping scope between rules and agents/skills
  • Duplicate workflow descriptions

Verbose Phrasing

  • Long paragraphs that can be shortened
  • Redundant examples
  • Over-explanation of obvious concepts

Memory Candidates

  • Static reference material rarely changing
  • Detailed examples not needed in every session
  • Background context that can be loaded on-demand

Output Format

# Claude Audit Report

## Files Analyzed
- [file count] files reviewed

## Findings

### Redundant Instructions
| File | Issue | Recommendation |
|------|-------|-----------------|
| file.md | Description | Action |

### Verbose Phrasing
| File | Section | Suggestion |
|------|---------|------------|
| file.md | section | concise version |

### Memory Candidates
| File | Content | Rationale |
|------|---------|-----------|
| file.md | section | why to move |

## Summary
- X redundant rules
- Y verbose sections
- Z candidates for memory

## Action Items
[ ] Implement specific fix

Present findings to the user and ask which to implement

Related skills
Installs
1
GitHub Stars
20
First Seen
Mar 21, 2026