skills.rest
blackwell-systems
blackwell-systemsCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/blackwell-systems/agent-lsp --skill lsp-rename
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
islee23520islee23520
5

lsp

Check workspace code with language-server tooling for diagnostics and refactoring.

Community
Intermediate
blackwell-systemsblackwell-systems
102

lsp-verify

Verify LSP diagnostics, build, and tests after code edits.

Community
Advanced
massgenmassgen
1.1k

serena

Locate symbol definitions and references across multi-file codebases using LSP-powered analysis.

Official
Advanced
axiomanticaxiomantic
8

using-lsp-tools

Provides semantic navigation and accurate extraction of text, tables, and metadata from PDF files.

Official
Intermediate