trace-mcp Codemod Workflow
Forces Claude to use trace-mcp's apply_codemod for any edit pattern repeated 2+ times instead of firing off repetitive Edit calls.
Dev & CodingIntermediate★ 140⑂ 19AI score 8/10Last updated: Sep 5, 2026
What it does
- Detects when the same kind of change is needed 2 or more times (one file or many) and routes it through trace-mcp's
apply_codemodregex bulk replace instead of repeatedEditcalls. - Enforces a standard loop: ① preview with
dry_run→ ② narrow scope viafilter_content/multiline→ ③ apply withdry_run: false(addconfirm_large: trueabove 20 files) → ④ verify with the test suite orcheck_quality_gatesatscope: "changed". - For cross-package or version-aware work (dependency upgrades), it starts with
plan_batch_changeto get an impact report before rewriting. - Calls out anti-patterns: using
Edit replace_allfor renames (useapply_rename), skipping dry-run, forgettingconfirm_large.
Who it's for
- Developers already running the trace-mcp MCP server.
- Teams doing frequent refactors, signature changes, or API migrations in large TypeScript/Python codebases.
- Anyone tired of Claude burning tokens on dozens of near-identical Edit calls.
Examples
- Signature change: rewrite
extractNodes(toextractNodes(ctx,acrosssrc/**/*.ts, limited byfilter_contentto files that import it. - Async migration: enable
multilineto matchfunction foo(...) {blocks and convert them toasync function. - Dependency upgrade: run
plan_batch_changefor lodash 4→5 to map affected files, then codemod the deprecated API calls.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/nikolai-vysotskyi/trace-mcp/HEAD/skills/trace-mcp-codemod/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/trace-mcp-codemod folder from the GitHub repo nikolai-vysotskyi/trace-mcp into my ~/.claude/skills/trace-mcp-codemod/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/nikolai-vysotskyi/trace-mcp.git /tmp/trace-mcp && mkdir -p ~/.claude/skills && cp -r /tmp/trace-mcp/skills/trace-mcp-codemod ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- First connect the trace-mcp MCP server to Claude Code — this skill only works if tools like
apply_codemodandplan_batch_changeare available (see the repo README for MCP setup). - Clone the repository:
git clone https://github.com/nikolai-vysotskyi/trace-mcp.git - Create the skills directory:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r trace-mcp/skills/trace-mcp-codemod ~/.claude/skills/ - Restart Claude Code and confirm
trace-mcp-codemodappears in your skills list. - Test it with a request like "replace every oldFunction call with newFunction across the project" and always inspect the dry-run preview before applying.
View source on GitHub ↗License: MIT