rename-symbol

Rename symbols and update all references across a codebase.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/eivindeb/agent-skills --skill rename-symbol
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rename-symbol
Source: https://github.com/eivindeb/agent-skills/tree/main/rename-symbol
Command: npx skills add https://github.com/eivindeb/agent-skills --skill rename-symbol

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures that when a symbol (like a variable, function, or class name) is renamed, all its references across the entire codebase are updated consistently, preventing orphaned references and semantic inconsistencies.

Core Features & Use Cases

  • Comprehensive Renaming: Updates direct and semantic references, including declarations, call sites, file names, and non-code references (comments, documentation).
  • Scope Clarification: Helps differentiate between exact symbol renames and conceptual root renames.
  • Use Case: Refactoring a large codebase by renaming a core data structure like UserData to UserProfile across all classes, methods, files, and associated documentation.

Quick Start

Use the rename-symbol skill to change all instances of 'old_function_name' to 'new_function_name' throughout 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 rename a function across an entire codebase without missing references?

To rename a function across an entire codebase, you must systematically update declarations, call sites, file names, and non-code references. Using a robust search mechanism like rg guarantees completeness by finding direct and semantic references.

What is the best way to refactor a core data structure name in documentation and code?

Refactoring a core data structure name requires comprehensive renaming that updates direct code references, file names, comments, and associated documentation. This prevents orphaned references and semantic inconsistencies during codebase maintenance.

Does IDE refactoring cover all symbol references during codebase maintenance?

IDE refactoring often misses non-code references, file names, and semantic call sites. A systematic symbol renaming approach using robust search tools like rg goes beyond typical IDE capabilities to guarantee complete reference updates.

How do I standardize variable names in comments and documentation during refactoring?

To standardize variable names in comments and documentation, you need a comprehensive renaming process that identifies and modifies non-code references alongside declarations and call sites, ensuring name standardization across the project.

Can I rename a symbol and its associated file names simultaneously?

Yes, comprehensive symbol renaming simultaneously updates declarations, call sites, and associated file names. This ensures all direct and semantic references are modified consistently across the entire codebase during code evolution.

When do I need to use a search tool like rg for symbol renaming?

You need a search tool like rg for symbol renaming when updating direct and semantic references across an entire codebase, as it guarantees completeness by finding orphaned references in declarations, call sites, files, and non-code documentation.