Skip to main content
plugin

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add softaworks/agent-toolkit
/plugin install agent-md-refactor@agent-toolkit
Open on GitHub

What 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.md instructions
  • link extracted documentation
  • move detailed guidance into separate files

Example prompts for the agent

  • Refactor AGENTS.md into 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-toolkit

Step 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

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

From the same set79

The whole set →
c4-architecture c4-architecture — a Claude Code plugin that generates architecture diagrams in C4 notation as Mermaid graphs. Use it to visualize system structure, document components, and show how parts interact. ★ 2,707repo stars backend-to-frontend-handoff-docs backend-to-frontend-handoff-docs creates API handoff documentation for frontend teams once backend development is finished. ★ 2,707repo stars skill-judge skill-judge — a Claude Code plugin that evaluates Agent Skills against official specifications and best practices. Use it to review SKILL.md files and skill packages, catching structural and formatting issues before publication. ★ 2,707repo stars plugin-forge plugin-forge — a Claude Code plugin that streamlines plugin creation and management, handling structure, manifests, and marketplace integration. Automates work with plugin.json, component setup, and version bumps. ★ 2,707repo stars command-creator command-creator builds custom slash commands for Claude Code. Helps convert routine multi-step workflows into reusable commands. ★ 2,707repo stars perplexity Connects Perplexity AI to Claude Code for live web search and information gathering. Helpful when you need current data, fact-checking, or research without leaving your editor. ★ 2,707repo stars gemini Delegates code reviews, plan checks, and large context processing to Gemini CLI. Triggers when context sizes exceed 200k tokens. ★ 2,707repo stars codex Connects Codex CLI into workflows for code analysis, refactoring, and automated edits. Triggers when running codex exec or codex resume commands. ★ 2,707repo stars

Project sponsors

Companies that keep this analytics open