agent-md-refactor — Claude Code plugin: what it does, install
The agent-md-refactor plugin breaks large agent instruction files into linked documents. Use it when AGENTS.md or CLAUDE.md has become a monolith.
MIT ★ 2,707 updated 2026-03-05
/plugin marketplace add softaworks/agent-toolkit
/plugin install agent-md-refactor@agent-toolkitWhat agent-md-refactor does
agent-md-refactor restructures oversized AGENTS.md, CLAUDE.md, and similar files that guide an AI agent. It separates one large document into organized pieces and links those pieces together. The result follows progressive disclosure, so details can sit outside the main instruction file.
The plugin contains the skills/agent-md-refactor skill. It focuses on documentation structure rather than project code. A large AGENTS.md is a direct candidate for this kind of split.
agent-md-refactor runs in Claude Code. Install it through the softaworks/agent-toolkit marketplace with the two plugin commands below. The project uses the MIT license.
What it helps with
- split a monolithic
AGENTS.md - restructure
CLAUDE.mdinstructions - link extracted documentation
- move detailed guidance into separate files
Example prompts for the agent
- Refactor
AGENTS.mdinto organized linked documents. - Apply progressive disclosure to
CLAUDE.md. - Find similar agent instruction files and reorganize their structure.
How to install agent-md-refactor
Plugin marketplace
/plugin marketplace add softaworks/agent-toolkit/plugin install agent-md-refactor@agent-toolkitStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about agent-md-refactor
How do I install agent-md-refactor in Claude Code?
Run /plugin marketplace add softaworks/agent-toolkit, then run /plugin install agent-md-refactor@agent-toolkit.
What does agent-md-refactor do?
It restructures oversized AGENTS.md, CLAUDE.md, and similar agent instruction files into organized documents with links between them.
Which files can agent-md-refactor refactor?
It works with AGENTS.md, CLAUDE.md, and similar files used to provide instructions to an agent.
Source text
agent-md-refactor · MIT
Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation. Skills: skills/agent-md-refactor
© softaworks · MIT · softaworks/agent-toolkit