Refactor safely

Skill cristianorj22/arthus-harness/plugins/mcp-code-review-graph/claude/skills/refactor-safely

Plan and execute safe refactoring using dependency analysis from the code-review-graph MCP. Use for renames, dead-code removal, or extract-function refactors where breadth-of-impact matters.From its SKILL.md

Install

npx -y skills add cristianorj22/arthus-harness --skill refactor-safely

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.6 KB, 338 tokens by cl100k_base, as published. Nobody here has run it

Refactor Safely

Use the knowledge graph to plan and execute refactoring with confidence.

Steps

Use refactor_tool with mode="suggest" for community-driven refactoring suggestions.
Use refactor_tool with mode="dead_code" to find unreferenced code.
For renames, use refactor_tool with mode="rename" to preview all affected locations.
Use apply_refactor_tool with the refactor_id to apply renames.
After changes, run detect_changes to verify the refactoring impact.

Safety Checks

Always preview before applying (rename mode gives you an edit list).
Check get_impact_radius before major refactors.
Use get_affected_flows to ensure no critical paths are broken.
Run find_large_functions to identify decomposition targets.

Token Efficiency Rules

ALWAYS start with get_minimal_context(task="<your task>") before any other graph tool.
Use detail_level="minimal" on all calls. Only escalate to "standard" when minimal is insufficient.
Target: complete any review/debug/refactor task in ≤5 tool calls and ≤800 total output tokens.

Cross-link

Pairs with refactor-cleaner agent — agent runs knip/depcheck/ts-prune; this skill does graph-driven dead-code + rename preview.
For SAFE-tier removals (orphan exports), prefer the refactor-cleaner agent. For STRUCTURAL refactors (rename a function used in 30 places), use this skill first.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.