lsp-rename

Rename symbols across a workspace with LSP preview and confirmation.

102|5|Updated Apr 6, 2026

Search Tags:#preview #workspace #rename #lsp #references #edits #symbol

Ready to run

npx skills add https://github.com/blackwell-systems/agent-lsp --skill lsp-rename

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: lsp-rename
Source: https://github.com/blackwell-systems/agent-lsp/tree/main/skills/lsp-rename
Command: npx skills add https://github.com/blackwell-systems/agent-lsp --skill lsp-rename

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This capability enables safe, two-phase renaming of symbols across a workspace, ensuring all impacted sites are identified and confirmed before changes are applied.

Core Features & Use Cases

Preview and verify the impact of renames across files so you can see every affected symbol, reference, and location before committing an edit.
Execute the rename in a controlled, two-step process with explicit user confirmation, while preserving code integrity.
Handle common scenarios like renaming functions, variables, types, or identifiers across multiple languages supported by agent-lsp, with robust guardrails and diagnostics comparison.

Quick Start

Provide the old name and the new name, ensure LSP is started for your workspace, then confirm the preview to execute the rename.

Frequently Asked Questions about lsp-rename

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

FAQPage Schema

How do I rename a symbol across multiple files in a workspace safely?▼

To safely rename a symbol across a workspace, this Skill uses a two-phase process that previews all affected references and locations before applying edits. You provide the old and new names, confirm the preview, and the changes are applied.

Can I preview workspace edits before renaming a function or variable?▼

Yes, you can preview workspace edits before renaming a function or variable. The Skill generates a dry-run preview showing every impacted symbol, reference, and location so you can verify the impact before committing any code changes.

Do I need an LSP server running to rename symbols across my project?▼

Yes, you need an LSP server running to rename symbols across your project. The Skill requires an active LSP server with rename capabilities and enforces a start_lsp guard to ensure the workspace is ready before attempting any edits.

What types of identifiers can I rename using an LSP workspace preview?▼

You can rename functions, variables, types, and other identifiers using an LSP workspace preview. The Skill handles common scenarios across multiple languages supported by agent-lsp, verifying all impacted sites before applying edits.

Why does my workspace symbol rename fail without explicit user confirmation?▼

A workspace symbol rename fails without explicit user confirmation because the Skill executes in a controlled, two-step process. It preserves code integrity by requiring you to review the dry-run preview and confirm before applying any edits.