serena-refactor

Rename symbols and update references across codebases with Serena MCP.

3|1|Updated Apr 2, 2015
One-click install
npx skills add https://github.com/ktrysmt/dotfiles --skill serena-refactor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: serena-refactor
Source: https://github.com/ktrysmt/dotfiles/tree/main/.claude/skills/serena-refactor
Command: npx skills add https://github.com/ktrysmt/dotfiles --skill serena-refactor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Large-scale code changes across a codebase can be error-prone when references go out of sync. This skill automates symbol-aware refactoring to ensure every usage stays consistent.

Core Features & Use Cases

  • Rename functions, classes, methods, or variables across files with all references updated.
  • Update signatures and propagate changes at call sites while preserving behavior.
  • Extract or move symbols into new modules or files without breaking dependencies.
  • Maintain cross-file integrity during complex restructuring.

Quick Start

Provide the target symbol and the desired change, then let Serena apply the updates across the entire codebase.

Frequently Asked Questions about serena-refactor

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

FAQPage Schema
How do I rename a function and update all references across a large codebase?

To rename a function and update references across a codebase, you perform symbol-aware refactoring to automatically track and modify every usage. This ensures all call sites and definitions remain consistent without manual searching.

What is symbol-aware refactoring and when do I need it for code restructuring?

Symbol-aware refactoring is the process of modifying code structures while tracking their semantic identities. You need it when extracting methods, moving classes, or updating signatures to prevent cross-file dependencies from breaking.

Can I update method signatures and automatically propagate changes to call sites?

Yes, you can update method signatures and propagate changes to call sites automatically. The refactoring operation tracks every reference to the target symbol and applies atomic updates to preserve program behavior.

Does this refactoring approach work for moving symbols into new modules without breaking dependencies?

Yes, this refactoring approach works for moving symbols into new modules without breaking dependencies. It maintains cross-file integrity by analyzing references and verifying post-change consistency across the project.

What is the best way to extract or move code symbols across files in a large project?

The best way to extract or move code symbols across large projects is using atomic refactoring operations with built-in reference tracking. This prevents out-of-sync references and ensures complex restructuring does not break dependencies.