agent-md-refactor

1# Agent MD Refactor
2 
3Refactor bloated agent instruction files (AGENTS.md, CLAUDE.md, COPILOT.md, etc.) to follow **progressive disclosure principles** - keeping essentials at root and organizing the rest into linked, categorized files.
4 
5---
6 
7## Triggers
8 
9Use this skill when:
10- "refactor my AGENTS.md" / "refactor my CLAUDE.md"
11- "split my agent instructions"
12- "organize my CLAUDE.md file"
13- "my AGENTS.md is too long"
14- "progressive disclosure for my instructions"
15- "clean up my agent config"
16 
17---
18 
19## Quick Reference
20 
21| Phase | Action | Output |
22|-------|--------|--------|
23| 1. Analyze | Find contradictions | List of conflicts to resolve |
24| 2. Extract | Identify essentials | Core instructions for root file |
25| 3. Categorize | Group remaining instructions | Logical categories |
26| 4. Structure | Create file hierarchy | Root + linked files |
27| 5. Prune | Flag for deletion | Redundant/vague instructions |
28 
29---
30 
31## Process
32 
33### Phase 1: Find Contradictions
34 
35Identify any instructions that conflict with each other.
36 
37**Look for:**
38- Contradictory style guidelines (e.g., "use semicolons" vs "no semicolons")
39- Conflicting workflow instructions
40- Incompatible tool preferences
41- Mutually exclusive patterns
42 
43**For each contradiction found:**
44```markdown
45## Contradiction Found
46 
47**Instruction A:** [quote]
48**Instruction B:** [quote]
49 
50**Question:** Which should take precedence, or should both be conditional?
51```
52 
53Ask the user to resolve before proceeding.
54 
55---
56…