rename-symbol

Rename symbols across codebases with grep, categorization, and type checks.

11|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/berkcangumusisik/claude-code-practices --skill rename-symbol-berkcangumusisik
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rename-symbol
Source: https://github.com/berkcangumusisik/claude-code-practices/tree/main/skills/rename-symbol
Command: npx skills add https://github.com/berkcangumusisik/claude-code-practices --skill rename-symbol-berkcangumusisik

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Safely rename a function, variable, type, or class across the entire codebase to ensure consistent references and reduce manual editing risk.

Core Features & Use Cases

  • Global symbol rename with analysis of definitions, references, imports/exports, and tests.
  • Categorization of occurrences (definitions, call sites, type annotations) to minimize breakages.
  • Safe, stepwise renaming with user confirmation and a final type check to verify consistency.

Quick Start

Provide the old symbol name and the new symbol name, review flagged occurrences, and apply the rename across the project.

Frequently Asked Questions about rename-symbol

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely rename a TypeScript symbol across an entire codebase?

To safely rename a TypeScript symbol across a codebase, locate occurrences with grep, categorize them by definitions or call sites, rename selectively, and run type checks to verify consistency.

What is the best way to refactor a variable name without breaking imports and exports?

Refactoring a variable name without breaking imports requires categorizing occurrences to track definitions, references, and exports, applying stepwise renaming with user confirmation, and running a final type check.

Does this codebase refactoring approach work with both .ts and .tsx file types?

Yes, this codebase refactoring approach works with multiple file types including .ts, .js, .tsx, and .jsx, ensuring consistent definitions and references across all supported formats during the symbol rename process.

How do I categorize grep search results for a codebase symbol rename?

Categorizing grep search results for a symbol rename involves grouping occurrences into definitions, call sites, type annotations, and tests to minimize breakages during the selective renaming process.

What steps are needed to verify type consistency after renaming a function in JavaScript?

To verify type consistency after renaming a function in JavaScript, apply the rename selectively across the project and run a final type check to report any errors and ensure consistent references.