Summary
If your AGENTS.md or CLAUDE.md has ballooned into a 500-line monolith, this walks you through splitting it into a minimal root file plus organized, linked documentation. It's built around progressive disclosure: keep only universal info at the top (commands, project basics), then move language-specific rules, testing patterns, and style guides into separate files like typescript.md or code-style.md. The process flags contradictions first, then helps you prune vague instructions like "write clean code" that just waste tokens. The checklist aims for a root file under 50 lines. Solid if you're drowning in agent instructions and need a structured cleanup.
Install to Claude Code
npx -y skills add davila7/claude-code-templates --skill agent-md-refactor --agent claude-codeInstalls into .claude/skills of the current project.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Files
SKILL.md
Select a file.
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
