Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

gitnexus-refactoring — Claude Code skill: setup and usage

Safely rename symbols, split services, and extract modules using GitNexus semantic graphs. It verifies call hierarchies before touching files.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add abhigyanpatwari/GitNexus --skill gitnexus-refactoring -a claude-code
Open on GitHub

What gitnexus-refactoring does

The skill orchestrates refactoring through GitNexus MCP tools without relying on plain text search. Before editing files, it runs impact and context queries to map inbound and outbound references across your repository. Comments and string literals stay untouched because the system relies strictly on scope resolution.

File edits follow a two-step execution pattern. Calling rename with dry_run: true returns a diff preview and a single-use plan_token. Applying edits to disk requires this token, which expires after 15 minutes. Unplanned disk writes are blocked by design.

If you manage multiple indexed projects, pass the repo parameter explicitly to avoid applying changes to the wrong tree. When the graph reports staleness, run node .gitnexus/run.cjs analyze in your terminal to reindex the repository.

What it helps with

  • rename functions and classes across files using semantic references
  • extract cohesive logic blocks into dedicated modules
  • split monolithic services into smaller components
  • preview code modifications before writing changes to disk

Example prompts for the agent

  • Rename function validateUser to authenticateUser across the my-app repository
  • Extract the session validation logic into a separate module
  • Split this payment service and check affected upstream callers

How to install gitnexus-refactoring

1Skills CLI (Vercel)

npx skills add abhigyanpatwari/GitNexus --skill gitnexus-refactoring -a claude-code

2Manually: put the files in place

~/.claude/skills/gitnexus-refactoring/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gitnexus-refactoring/

Similar

dependency-upgrade Seth Hobson This skill plans major dependency upgrades, checks compatibility, and stages changes with tests. Use it for framework updates or library breaking changes. Claude Code CX Codex Cursor 11,079installs scope-creep-detector Matt Van Horn Compares a git diff against a stated intent and flags files that don't belong: stray dependencies, API renames, config edits, oversized hunks, and formatting. Runs locally, offline, no network calls. Claude Code CX Codex Cursor +1 605installs react-native-best-practices callstackincubator Provides React Native performance guidelines based on Callstack practices. It helps agents diagnose FPS drops, memory leaks, and large bundles. Claude Code CX Codex Cursor +1 30,100installs deslop cursor Inspects branch diffs against main to remove AI-generated code clutter and inconsistent styling. Ideal for polishing branch changes before pull request review. Claude Code CX Codex Cursor +1 9,300installs parallel-debugging Seth Hobson This skill investigates complex bugs by testing competing hypotheses in parallel. Use it when an issue has several plausible causes or crosses multiple components. Claude Code CX Codex Cursor 10,000installs parallel-feature-development Seth Hobson This skill splits a large feature into parallel work streams, assigns file ownership, and guides integration. Use it when several agents share one codebase. Claude Code CX Codex Cursor 9,900installs improve-codebase-architecture Matt Pocock This skill scans a codebase for architectural friction, then builds a visual HTML report with refactoring candidates. Use it before a deeper architecture review. Claude Code 1,163,035installs tdd Matt Pocock Guides the red-green TDD loop: ensures tests are written first, keep them at public interfaces, and avoid coupling to implementation details. Claude Code 1,141,062installs

Questions about gitnexus-refactoring

How to install gitnexus-refactoring in Claude Code?

Run npx skills add abhigyanpatwari/GitNexus --skill gitnexus-refactoring -a claude-code. The skill will be configured in ~/.claude/skills/gitnexus-refactoring/SKILL.md.

What does gitnexus-refactoring do?

It analyzes code relationships using a local graph, previews semantic renames, and applies validated multi-file refactoring steps.

How does the skill prevent accidental code overwrites?

It requires generating a preview first to obtain a plan_token. Disk writes fail unless executed with this valid single-use token.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor