Skip to content
cccskills
FreePublished on GitHub

refactor-safely

Plan refactoring with dependency analysis, which shows how code parts rely on each other. Find candidates and unreferenced code, preview and apply renames, and compare the resulting impact with the original plan.

OriginalShow the original description

Plan and execute safe refactoring using dependency analysis

See how to install

Good for

  • Finding refactoring candidates and unreferenced code
  • Previewing edits before applying a rename
  • Checking affected dependencies and execution paths
  • Comparing post-change impact with the refactoring plan

Files included (1)

  • SKILL.md1.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Refactor Safely

Plan a refactor from the dependency graph and apply renames from a preview.

Steps

  1. Call refactor_tool with mode="suggest" for refactoring candidates, or mode="dead_code" for unreferenced code.
  2. For a rename, call refactor_tool with mode="rename", old_name and new_name. Check the returned edit list before applying.
  3. Call apply_refactor_tool with the returned refactor_id to apply the rename.
  4. Before a large refactor, call get_impact_radius_tool and get_affected_flows_tool to see the dependents and critical paths involved.
  5. Call find_large_functions_tool to find functions worth splitting.
  6. After the change, call detect_changes_tool to confirm the impact matches the plan.

Token Efficiency Rules

  • Call get_minimal_context_tool(task="<your task>") before any other graph tool.
  • Pass detail_level="minimal" wherever a tool accepts it. Use "standard" only when minimal is not enough.
  • Prefer a targeted query_graph_tool call over a broad listing call.
  • Budget: about five tool calls and 800 tokens of graph output per task.
  • Read the implementation and its tests before changing code. The graph narrows scope; it does not replace the source.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

build-graph

FreeSummary

Build or refresh a knowledge graph, a map of code relationships used for code review. Choose a full rebuild or an incremental update, then report the operation's status and summary.

  • Setting up the graph for a repository's first review
  • Refreshing the graph after switching branches
  • Updating review data after a large refactor
tirth8205/code-review-graph32.3KUpdated Oct 16, 2026

debug-issue

FreeSummary

Investigate bugs using a graph of code relationships. Find relevant functions, trace calls and execution paths, check recent changes, and assess what a proposed fix could affect before reading and changing the implementation.

  • Narrowing down code related to a bug
  • Tracing the execution path that triggers an issue
  • Checking whether recent changes caused a bug
tirth8205/code-review-graph32.3KUpdated Oct 16, 2026

explore-codebase

FreeSummary

Explore an unfamiliar codebase using a graph of code relationships. Inspect its structure, find functions and classes, trace calls and imports, follow execution paths, and locate large functions for closer investigation.

  • Understanding the structure of an unfamiliar codebase
  • Finding functions and classes by name or keyword
  • Tracing calls, imports, and execution paths
tirth8205/code-review-graph32.3KUpdated Oct 16, 2026

review-changes

FreeSummary

Review code changes using a knowledge graph, a map of code relationships, to assess risk and affected behavior. Organize findings by severity, identify missing tests, suggest fixes, and provide a merge recommendation.

  • Prioritizing review findings by risk
  • Checking how changed functions affect other code
  • Identifying missing tests and proposing test cases
tirth8205/code-review-graph32.3KUpdated Oct 16, 2026

review-delta

FreeSummary

Review code changes against the previous commit and identify affected files and functions. Use dependency relationships to assess risk, check missing tests, and produce a focused report with issues and recommendations.

  • Reviewing changes against the previous commit
  • Checking how a change affects other functions
  • Finding missing tests for high-risk changes
tirth8205/code-review-graph32.3KUpdated Oct 16, 2026

review-pr

FreeSummary

Review all changes in a pull request or branch against its base branch. Use a knowledge graph, a map of code relationships, to report affected files and functions, test coverage, API compatibility issues, and recommended actions.

  • Reviewing all commits in a pull request
  • Checking a branch's changes against its base
  • Finding callers missed by public API changes
tirth8205/code-review-graph32.3KUpdated Oct 16, 2026

See all skills by tirth8205

Report a problem with this skill