agent-md-refactor

Refactor 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. Use this skill when: Identify any instructions that conflict with each other. Look for: For each contradiction found: Ask the user to resolve before proceeding. Extract ONLY what belongs in the root agent file. The root should be minimal - information that applies to every single task . Essential content (keep in root): NOT essential (move to linked files): Organize remaining instructions into logical categories. Common categories: Grouping rules: Output structure: Root file template: Each linked file template: Identify instructions that should be removed entirely. Delete if: Output format: After refactoring, verify: - "refactor my AGENTS.md" / "refactor my CLAUDE.md" - "split my agent instructions" - "organize my CLAUDE.md file" - "my AGENTS.md is too long" - "progressive disclosure for my instructions" - "clean up my agent config" - Contradictory style guidelines (e.g., "use semicolons" vs "no semicolons") - Conflicting workflow instructions - Incompatible tool preferences - Mutually exclusive patterns - Language-specific conventions - Testing guidelines - Code style details - Framework patterns - Documentation standards - Git workflow details - Each file should be...