Refactor monolithic agent instruction files into linked markdown documents.
npx skills add https://github.com/compozy/agh --skill agent-md-refactor-compozy
Please help me install this Agent Skill. Skill: agent-md-refactor Source: https://github.com/compozy/agh/tree/main/.agents/skills/agent-md-refactor Command: npx skills add https://github.com/compozy/agh --skill agent-md-refactor-compozy
This Skill fixes bloated, contradictory, and hard-to-maintain agent instruction files by minimizing the root document and moving focused guidance into linked sub-documents to reduce context waste.
Tell the agent to refactor your AGENTS.md by applying progressive disclosure so the root becomes minimal and the rest is split into linked topic files.
High-intent search queries and answers about installing and using this skill.
Refactoring a large CLAUDE.md or AGENTS.md file involves applying progressive disclosure to extract universal essentials into a minimal root document, then relocating remaining categorized guidance into self-contained, linked markdown files to reduce context token waste.
Progressive disclosure for agent instructions is a structuring technique that minimizes the root document and moves focused guidance into linked sub-documents. Use it when monolithic instruction files become too long, mix unrelated topics, or waste context tokens.
Finding and resolving contradictions in agent instruction documents requires scanning the monolithic file for conflicting directives. You must resolve instruction precedence first before restructuring the document into progressively disclosed, linked markdown files.
Yes, you can prune redundant, vague, default, or outdated directives while restructuring markdown documentation. During the progressive disclosure refactor, the process flags these unnecessary instructions for deletion and verifies link consistency across the generated files.
The best way to split a bloated agent instruction file is to extract only universal essentials to the root, categorize remaining guidance into self-contained files like code style or testing, and verify link consistency to ensure a maintainable hierarchy.
billlzzz26Refactor bloated agent instruction files into a minimal root with linked documentation.
LAI-YEN-CHUNOptimize context usage in agent systems with progressive disclosure and context budgets.
bahayonghangAudit Claude Code context files and propose optimization diffs.
imMamdouhaboammarRefactor monolithic agent instruction files into modular linked documentation.
