agent-md-refactor

To organize messy agent instructions, you refactor the monolithic file by applying progressive disclosure. The Skill extracts essential, universal instructions into a concise root file and moves detailed guidelines into linked, categorized sub-documents for better readability and maintenance.

Progressive disclosure for agent instruction files is a structuring technique that splits a monolithic document into a concise root file and linked, categorized sub-files. This separates universal rules from detailed guidelines, making the instructions easier to read, maintain, and use.

To refactor a CLAUDE.md file with conflicting instructions, the Skill identifies and helps resolve contradictions during the reorganization. It separates rules into categorized sub-files and flags redundant or vague instructions for deletion to ensure consistency.

Yes, you can split language-specific guidelines out of a root AGENTS.md file. The Skill extracts universal instructions into the root file and categorizes language-specific, testing, or style guidelines into separate, linked markdown documents like typescript.md or testing.md.

The best way to clean up redundant rules in agent instructions is to refactor the file using progressive disclosure. The Skill flags redundant and vague instructions for deletion while organizing the remaining content into a structured root file and linked sub-documents.