agent-md-refactor

To refactor agent instruction files, this Skill restructures monolithic configurations into a concise root file with links to categorized markdown files, applying progressive disclosure to keep essential details accessible while moving specialized instructions away.

Progressive disclosure organizes agent instructions by retaining essential root configurations in the primary file while migrating less critical or specialized details into linked, categorized markdown files, ensuring improved clarity and maintainability for complex setups.

Splitting a massive CLAUDE.md file involves identifying essential root instructions, categorizing remaining details into separate linked files like code-style.md or testing.md, and flagging redundant or vague content for deletion to improve maintainability.

Yes, during the refactoring process, the Skill identifies conflicting instructions within the original monolithic file to ensure consistency across the newly structured, multi-file agent configuration.

While progressive disclosure improves clarity by splitting configurations into linked files, it requires maintaining multiple markdown files instead of one, which may complicate version control if your agent setup is extremely simple or does not require categorized instructions.