Claude Code Agent Markdown Refactor for Project Instructions
Turn a long CLAUDE.md or AGENTS.md into a concise entry point and linked topic documents. Surface contradictions before moving test, style, and contribution conventions.
中文Install in Claude Code
Use Claude Code in a local checkout with existing project instruction files and related documentation.
- Get the complete `cli-tool/components/skills/development/agent-md-refactor` directory from the pinned GitHub checkout.
- Copy it under the target project's `.claude/skills/`. Confirm `.claude/skills/agent-md-refactor/SKILL.md`, open Claude Code at the project root, and call `/agent-md-refactor`.
Example task
Split a fictional 120-line CLAUDE.md into a short overview, testing rules, and TypeScript rules. The old file calls for both two-space and four-space indentation. Preserve the conflict for review.What to check
Expect a short entry point and two reachable topic documents. Both indentation rules remain flagged for a decision, and the test command can still be found from the overview.
Original SKILL.md on GitHub · Updated
Frequently asked question
Can the refactor choose between contradictory rules automatically?
Present both original rules and their scope to the maintainer. Move the unaffected rules and preserve their entry links.