skill

agent-md-refactor — Claude Code skill: what it does, how to install

Q: How to install agent-md-refactor in Claude Code?

Run `npx claude-code-templates@latest --skill development/agent-md-refactor` in your terminal.

Splits oversized CLAUDE.md or AGENTS.md files into modular docs. It leaves only universal directives in root and links out to detailed subtopics.

Install into Claude Code · claude-code-templates All methods and platforms ↓

npx claude-code-templates@latest --skill development/agent-md-refactor

Open on GitHub

What agent-md-refactor does

The skill breaks monolithic agent instruction files into a lean root file and linked documents inside .claude/. The main document retains only context relevant to every single task: a brief project summary, package manager nuances, and custom build scripts. Specific areas like TypeScript rules, testing practices, and architecture patterns migrate into standalone guides.

Execution moves across five distinct steps: flagging contradictions, extracting essential defaults, sorting guidelines into topical files, generating markdown links, and pruning dead weight. It targets vague phrasing, obvious programming basics, and redundant settings for deletion.

If your current instructions contain opposing rules, the skill pauses immediately during analysis and demands a manual resolution.

What it helps with

shrink bloated root CLAUDE.md files
uncover conflicting guidelines inside agent documentation
strip vague rules and generic advice from instructions
split coding conventions into focused topic files

Example prompts for the agent

Refactor my CLAUDE.md using progressive disclosure
Split this long AGENTS.md into separate topic files
Check agent instructions for conflicts and eliminate fluff

How to install agent-md-refactor

1claude-code-templates

npx claude-code-templates@latest --skill development/agent-md-refactor

2Skills CLI (Vercel)

npx skills add davila7/claude-code-templates --skill agent-md-refactor -a claude-code

3Manually: put the files in place

~/.claude/skills/agent-md-refactor/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/agent-md-refactor/

Manually: put the files in place

.agents/skills/agent-md-refactor/SKILL.md

For all projects use ~/.agents/skills/

Manually: put the files in place

.cursor/skills/agent-md-refactor/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install davila7/claude-code-templates agent-md-refactor

2Manually: put the files in place

.github/skills/agent-md-refactor/SKILL.md

Platform CLI

gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/agent-md-refactor

Manually: put the files in place

.devin/skills/agent-md-refactor/SKILL.md

The legacy .windsurf/skills/ path still works

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about agent-md-refactor

How to install agent-md-refactor in Claude Code?

Run npx claude-code-templates@latest --skill development/agent-md-refactor in your terminal.

What is agent-md-refactor?

It is an agent skill that restructures monolithic instruction files into a clean root index linked to specific guideline documents.

What content stays in the root instruction file?

The root retains only project-wide essentials: a single-sentence overview, non-standard package managers, custom test or build commands, and universal requirements.

setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set804

The whole set →

retrospective-analyzer Runs retrospective analysis on sprint git commits and Linear completion data. Helps engineering teams track metrics and plan concrete action items. 196installs tdd-workflow Guides Claude Code through the test-driven development loop: write a failing test first, make it pass with simple code, then refactor. 194installs voice-agents Walks you through picking a voice agent architecture, budgeting latency and handling interruptions without awkward pauses. 194installs production-code-audit This skill scans a codebase, finds architecture, security, performance, and quality issues, then applies fixes. Use it when preparing a project for production. 193installs monte-carlo-simulator A slash command that runs Monte Carlo simulations: probability distributions, confidence intervals and risk metrics. 193installs cc-skill-security-review Security checklist and defensive code patterns for Claude Code. Guides the assistant during authentication setup and API endpoint creation. 192installs tdd-gate The hook blocks edits to production files until a matching test exists. Useful if you want the agent to keep the TDD order. 192installs README README outlines language-focused subagents and their ecosystems. Use it to find a specialist for coding, modernization, or performance work. 192installs