build-graph
Build or update the code review knowledge graph. Run this first to initialise, or let hooks keep it updated automatically.
@tirth8205Install SkillCode Review
Skill
/refactor-safely
Plan and execute safe refactoring using dependency analysis
Claude Code
$ npx -y skills add tirth8205/code-review-graph --skill refactor-safely --agent claude-code
Codex
$ npx skills add tirth8205/code-review-graph --skill refactor-safely -a codex -y
Cursor
$ npx skills add tirth8205/code-review-graph --skill refactor-safely -a cursor -y
Gemini CLI
$ npx skills add tirth8205/code-review-graph --skill refactor-safely -a gemini-cli -y
GitHub Copilot
$ npx skills add tirth8205/code-review-graph --skill refactor-safely -a github-copilot -y
OpenCode
$ npx skills add tirth8205/code-review-graph --skill refactor-safely -a opencode -y
Windsurf
$ npx skills add tirth8205/code-review-graph --skill refactor-safely -a windsurf -y
SKILL.md
refactor-safely.SKILL.mdname: refactor-safely
description: Plan and execute safe refactoring using dependency analysis
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"` unless it is not enough. Minimal drops source, so leave `semantic_search_nodes_tool(include_source=True)` and `get_review_context_tool` at standard.
- Prefer a targeted `query_graph_tool` call over a broad listing call.
- Budget: about five tool calls per task. Source snippets stand in for file reads.
- Read the implementation and its tests before changing code. The graph narrows scope; it does not replace the source.
Read more
name: refactor-safely description: Plan and execute safe refactoring using dependency analysis
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"` unless it is not enough. Minimal drops source, so leave `semantic_search_nodes_tool(include_source=True)` and `get_review_context_tool` at standard.
- Prefer a targeted `query_graph_tool` call over a broad listing call.
- Budget: about five tool calls per task. Source snippets stand in for file reads.
- Read the implementation and its tests before changing code. The graph narrows scope; it does not replace the source.
Stats
32,749
Stars
2,978
Forks
Active
Maintenance
Python
Language
MIT
License
Last commit
Created
Ships withcode-review-graph
Local-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.
33k7 skills1 MCP
Stars on GitHub
Momentum
- stars in total
- 32.7k
Other skills on code-review-graph.
@tirth8205Install Skillexplore-codebase
Navigate and understand codebase structure using the knowledge graph
@tirth8205Install Skillreview-changes
Perform a structured code review using change detection and impact
@tirth8205Install Skillreview-delta
Review only changes since last commit using impact analysis. Token-efficient delta review with automatic blast-radius detection.
@tirth8205Install Skillreview-pr
Review a PR or branch diff using the knowledge graph for full structural context. Outputs a structured review with blast-radius…
@tirth8205Install SkillMore skills from other plugins.
open-code-review
Performs AI-powered code review on Git changes using the `ocr` CLI from alibaba/open-code-review. Use when the user asks to…
@alibabaInstall Skilladdressing-pr-review-c…
Address all valid review comments on a PR for the current branch in the streamlit/streamlit repo. Covers both inline review…
@streamlitInstall Skillhunk-extensions
Maps the `hunkdiff/extension` authoring surface for Hunk, the terminal diff viewer — hiding or reordering reviewed files, docked…
@modem-devInstall Skill
Questions about refactor-safely.
- Which coding agents can use refactor-safely?
- refactor-safely installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.