Agent MD Refactor

by softaworks

Agent MD Refactor is an AI Engineering skill for Claude Code, published by softaworks in agent-toolkit.

2.4K stars219 forkson softaworks/agent-toolkitAdded 2026/08/18+1% in starsRepository updated 2026/03/05

View source on GitHub Download repo ZIP

agent-skillsaiautomationclaudeclaude-codecoding-agentdevelopment

Install in seconds

Install Agent MD Refactor

Copy Agent MD Refactor into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/softaworks/agent-toolkit/tree/main/skills/agent-md-refactor ~/.claude/skills/agent-md-refactor

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/softaworks/agent-toolkit.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/agent-md-refactor/SKILL.md in softaworks/agent-toolkit
Installs to: ~/.claude/skills/agent-md-refactor
Collection: One of 25 skills cataloged from this repository
Category: AI Engineering — 2451 skills

What Agent MD Refactor does

Agent MD Refactor restructures bloated agent instruction files like AGENTS.md and CLAUDE.md into concise root files with linked, categorized docs. Use it when an AI coding agent's instructions have grown too long, redundant, or contradictory.

Agent MD Refactor is cataloged under AI Engineering on DirSkills. Agent MD Refactor comes from a repository tagged agent-skills, ai, automation, claude and claude-code.

Documentation

README

Excerpt

Agent MD Refactor

Refactor bloated agent instruction files (AGENTS.md, CLAUDE.md, COPILOT.md, etc.) to follow progressive disclosure principles - keeping essentials at root and organizing the rest into linked, categorized files.

Triggers

Use this skill when:

"refactor my AGENTS.md" / "refactor my CLAUDE.md"
"split my agent instructions"
"organize my CLAUDE.md file"
"my AGENTS.md is too long"
"progressive disclosure for my instructions"
"clean up my agent config"

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Agent MD Refactor

What else does softaworks publish alongside Agent MD Refactor?
Agent MD Refactor is one of 25 skills that DirSkills catalogs from softaworks/agent-toolkit, the repository it ships in. Its siblings there include 10x Mode, Add Skill and Backend to Frontend Handoff Docs. Each one is a separate skill with its own page in this directory, installs the same way Agent MD Refactor does, and is maintained by softaworks in that same repository. The rest of the collection is listed on the softaworks/agent-toolkit page.
How does Agent MD Refactor compare to other AI Engineering skills?
Agent MD Refactor ranks #819 by stars among the 2451 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Agent MD Refactor against them. Open each page to compare what they document and how they install.