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.
npx skills add https://github.com/davila7/claude-code-templates --skill agent-md-refactor