agent-md-refactor

Refactor bloated agent instruction files into organized, linked documentation using progressive disclosure. 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.