Agent skill

Lsp Refactoring

Intelligent code refactoring using IDE-level tools (rename, find-references, go-to-definition), AST-aware pattern matching, and TDD verification.

Apache-2.0Auto-check passedDevelopment

Install Lsp Refactoring

skills CLI

$ npx skills add ArabelaTso/Skills-4-SE --skill lsp-refactoring -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install ArabelaTso/Skills-4-SE lsp-refactoring --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/ArabelaTso/Skills-4-SE.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/lsp-refactoring .claude/skills/lsp-refactoring && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "lsp-refactoring" agent skill from https://github.com/ArabelaTso/Skills-4-SE/tree/main/skills/lsp-refactoring into .claude/skills/lsp-refactoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lsp-refactoring", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/ArabelaTso/Skills-4-SE/tree/main/skills/lsp-refactoring

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add ArabelaTso/Skills-4-SE --skill lsp-refactoring -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install ArabelaTso/Skills-4-SE lsp-refactoring --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ArabelaTso/Skills-4-SE.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/lsp-refactoring .agents/skills/lsp-refactoring && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "lsp-refactoring" agent skill from https://github.com/ArabelaTso/Skills-4-SE/tree/main/skills/lsp-refactoring into .agents/skills/lsp-refactoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lsp-refactoring", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ArabelaTso/Skills-4-SE --skill lsp-refactoring -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install ArabelaTso/Skills-4-SE lsp-refactoring --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ArabelaTso/Skills-4-SE.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/lsp-refactoring .cursor/skills/lsp-refactoring && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "lsp-refactoring" agent skill from https://github.com/ArabelaTso/Skills-4-SE/tree/main/skills/lsp-refactoring into .cursor/skills/lsp-refactoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lsp-refactoring", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/ArabelaTso/Skills-4-SE.git --path skills/lsp-refactoring

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add ArabelaTso/Skills-4-SE --skill lsp-refactoring -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install ArabelaTso/Skills-4-SE lsp-refactoring --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ArabelaTso/Skills-4-SE.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/lsp-refactoring .gemini/skills/lsp-refactoring && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "lsp-refactoring" agent skill from https://github.com/ArabelaTso/Skills-4-SE/tree/main/skills/lsp-refactoring into .gemini/skills/lsp-refactoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lsp-refactoring", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install ArabelaTso/Skills-4-SE lsp-refactoring

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add ArabelaTso/Skills-4-SE --skill lsp-refactoring -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/ArabelaTso/Skills-4-SE.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/lsp-refactoring .github/skills/lsp-refactoring && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "lsp-refactoring" agent skill from https://github.com/ArabelaTso/Skills-4-SE/tree/main/skills/lsp-refactoring into .github/skills/lsp-refactoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lsp-refactoring", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ArabelaTso/Skills-4-SE --skill lsp-refactoring -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install ArabelaTso/Skills-4-SE lsp-refactoring --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ArabelaTso/Skills-4-SE.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/lsp-refactoring .opencode/skills/lsp-refactoring && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "lsp-refactoring" agent skill from https://github.com/ArabelaTso/Skills-4-SE/tree/main/skills/lsp-refactoring into .opencode/skills/lsp-refactoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lsp-refactoring", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: lsp-refactoring
GitHub stars: 253
Token cost: ~1.1k tokens
SKILL.md length: 413 words
Files: 1
Skills in repo: 170
Repo updated: Aug 21, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Intelligent code refactoring using IDE-level tools (rename, find-references, go-to-definition), AST-aware pattern matching, and TDD verification.

Works in 4 steps: Analysis — Understand Before Changing → Plan — Design the Transformation → Execute — Apply Changes Safely → …
Large-scale refactoring with precision
SKILL.md covers When to Use This Skill, What This Skill Does, Approach by Language and Anti-Patterns, plus 1 more section
Calls git, go and tsc

What it does

Lsp Refactoring is an agent skill from ArabelaTso/Skills-4-SE. Intelligent code refactoring using IDE-level tools (rename, find-references, go-to-definition), AST-aware pattern matching, and TDD verification. Use for safe, large-scale refactoring with precision.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Refactoring, Codebase onboarding and Test-driven development. The repository describes itself as: A curated list of 180+ useful Claude Skills for Software Engineering and resources for customizing AI for SE workflows. The licence is Apache-2.0.

When your agent uses it

Large-scale refactoring with precision
Tasks that involve Refactoring
Tasks that involve Codebase onboarding

Example prompts

“/lsp-refactoring”

Requirements

Python 3
Node.js

Workflow steps

4 steps, taken from the step headings in SKILL.md.

Analysis — Understand Before Changing
Plan — Design the Transformation
Execute — Apply Changes Safely
Verify — TDD Confirmation

What it can do on your machine

Read from SKILL.md and the folder at commit 4f38503. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- git
- go
- tsc
- npx
- mypy
- cargo
- npm
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- github.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Lsp Refactoring loads about 1.1k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 413 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~54
When it runs · the whole SKILL.md, loaded when a task matches: ~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ArabelaTso/Skills-4-SE at commit 4f38503, republished under its Apache-2.0 licence (© ArabelaTso). 413 words, ~1,068 tokens.

Download SKILL.mdSave it as .claude/skills/lsp-refactoring/SKILL.md (or your agent's skills folder).

name: lsp-refactoring
description: Intelligent code refactoring using IDE-level tools (rename, find-references, go-to-definition), AST-aware pattern matching, and TDD verification. Use for safe, large-scale refactoring with precision.

LSP Refactoring

Refactoring workflow that combines language server capabilities with code search and test-driven verification for safe, precise code transformations.

When to Use This Skill

Renaming symbols across an entire workspace
Extracting functions, classes, or modules
Moving code between files with automatic reference updates
Large-scale pattern-based code transformations
Any refactoring where manual find-replace is error-prone

What This Skill Does

Phase 1: Analysis — Understand Before Changing

Scope assessment: Find all usages of the target symbol using grep or IDE references
Dependency graph: Trace where the symbol is defined and what depends on it
Impact analysis: Identify all files that will be affected
Pattern discovery: Search for similar patterns that should be refactored consistently

bash

# Find all usages of a function
grep -rn "getUserData" src/ --include="*.ts"

# Find pattern across codebase with AST-aware tools (if available)
# e.g., ast-grep, semgrep, or comby
ast-grep --pattern 'console.log($MSG)' --lang typescript

Phase 2: Plan — Design the Transformation

Pre-flight check: Run the type checker / linter to capture baseline errors
Rename validation: Verify the symbol can be safely renamed (no conflicts)
Transformation plan: List each change with file, line, before/after
Test identification: Find tests covering the code being refactored

Phase 3: Execute — Apply Changes Safely

For renames (use IDE/editor capabilities when available):

bash

# Using sed for simple renames
find src/ -name "*.ts" -exec sed -i '' 's/getUserData/fetchUserProfile/g' {} +

# Or use language-specific tools
# TypeScript: ts-morph, jscodeshift
# Python: rope, bowler
# Go: gorename

For pattern-based transformations:

bash

# Using ast-grep (if installed)
ast-grep --pattern 'console.log($MSG)' --rewrite 'logger.info($MSG)' --lang typescript

# Using comby
comby 'console.log(:[msg])' 'logger.info(:[msg])' .ts

For structural changes (extract/move):

Create the new target (file, function, class)
Move the code
Update all references using LSP rename
Remove the old code
Verify no dangling references

Phase 4: Verify — TDD Confirmation

Type check: Run the project type checker — must be clean

bash

npx tsc --noEmit          # TypeScript
mypy src/                  # Python
go vet ./...               # Go

Build check: Run project build — must pass
Test check: Run test suite — all previously passing tests must still pass
Diff review: git diff to review the complete changes for unintended modifications

If any check fails:

Revert changes: git checkout -- .
Analyze the failure
Adjust approach and retry

Show full SKILL.md (133 more words)Show less

Approach by Language

Language	Rename Tool	Pattern Search	Type Check
TypeScript	`ts-morph`, `jscodeshift`	`ast-grep`, `semgrep`	`tsc --noEmit`
Python	`rope`, `bowler`	`ast-grep`, `semgrep`	`mypy`, `pyright`
Go	`gorename`, `gopls`	`ast-grep`, `semgrep`	`go vet`
Java	IntelliJ refactor, `openrewrite`	`semgrep`	`javac`
Rust	`rust-analyzer`	`ast-grep`	`cargo check`

Anti-Patterns

Manual find-replace without verifying all references — misses dynamic usages
Skipping type check after rename — may introduce type errors
Not running tests after refactoring — behavior may have changed
Refactoring while fixing bugs — do one or the other, never both

Example

User: "Rename getUserData to fetchUserProfile across the project"

Output:

grep -rn finds 23 usages across 8 files
Applies rename using sed/jscodeshift across all locations
tsc --noEmit passes with no errors
npm test — 47 tests pass
git diff shows clean, focused changes

Inspired by: oh-my-opencode /refactor command

Files

Just SKILL.md in skills/lsp-refactoring of ArabelaTso/Skills-4-SE.

Open the folder on GitHubat commit 4f38503

Compare with similar skills

Lsp Refactoring next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Lsp Refactoring compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Lsp Refactoring this skillArabelaTso/Skills-4-SE	253	—	~1.1k	Automated safety check: Pass	Apache-2.0	1 mo ago
Devnpc-live/clawfirm	156	—	~642	Automated safety check: Pass	None	3 mo ago
Solidramziddin/solid-skills	606	—	~2.7k	Automated safety check: Pass	None	1 mo ago
Ast GrepBiFangKNT/mtga	1.2k	—	~802	Automated safety check: Pass	AGPL-3.0	3 mo ago
Lsp Code Analysislsp-client/lsp-skill	118	—	~3k	Automated safety check: Pass	MIT	8 mo ago
Gograph Go Repository Intelligenceozgurcd/gograph	228	—	~4.8k	Automated safety check: Notes	MIT	yesterday

Similar skills

Dev
npc-live/clawfirm
Software development workflow dispatcher. An agent skill from npc-live/clawfirm.
156 GitHub stars~642 tokensUpdated 3 mo ago
Testing & QAAuto-check passed
Solid
ramziddin/solid-skills
A skill your agent uses when writing code, implementing features, refactoring, planning architecture, designing systems, reviewing code, or debugging.
606 GitHub stars~2.7k tokensUpdated 1 mo ago
DevelopmentAuto-check passed
Ast Grep
BiFangKNT/mtga
Write and debug ast-grep rules for structural code search and rewrite.
1.2k GitHub stars~802 tokensUpdated 3 mo ago
DevelopmentAuto-check passed
Lsp Code Analysis
lsp-client/lsp-skill
Semantic code analysis via LSP. An agent skill from lsp-client/lsp-skill.
118 GitHub stars~3k tokensUpdated 8 mo ago
DevelopmentAuto-check passed
Gograph Go Repository Intelligence
ozgurcd/gograph
Gives an agent working in a Go codebase a structural view through a local MCP server: call graphs, blast-radius and impact analysis, and bounded first-call exploration.
228 GitHub stars~4.8k tokensUpdated yesterday
DevelopmentAuto-check: notes
Skill Writing
millionco/expect
Write and improve agent skills (SKILL.md files). An agent skill from millionco/expect.
3.6k GitHub stars~1.8k tokensUpdated 5 mo ago
DevelopmentAuto-check passed

Questions about Lsp Refactoring

What does Lsp Refactoring do?

Intelligent code refactoring using IDE-level tools (rename, find-references, go-to-definition), AST-aware pattern matching, and TDD verification. Lsp Refactoring is an agent skill from ArabelaTso/Skills-4-SE. Intelligent code refactoring using IDE-level tools (rename, find-references, go-to-definition), AST-aware pattern matching, and TDD verification.

When should I use Lsp Refactoring?

Lsp Refactoring fits situations like: large-scale refactoring with precision; tasks that involve Refactoring; tasks that involve Codebase onboarding.

How do I install Lsp Refactoring in Claude Code?

Run `npx skills add ArabelaTso/Skills-4-SE --skill lsp-refactoring -a claude-code`. Or copy the skill folder (skills/lsp-refactoring in ArabelaTso/Skills-4-SE) into .claude/skills/lsp-refactoring in your project. Claude Code loads it when a task matches its description.

How do I install Lsp Refactoring in Codex?

Run `npx skills add ArabelaTso/Skills-4-SE --skill lsp-refactoring -a codex`. Or copy the skill folder (skills/lsp-refactoring in ArabelaTso/Skills-4-SE) into .agents/skills/lsp-refactoring in your project. Codex loads it when a task matches its description.

Can I use Lsp Refactoring in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ArabelaTso/Skills-4-SE --skill lsp-refactoring -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/lsp-refactoring, .gemini/skills/lsp-refactoring, .github/skills/lsp-refactoring and .opencode/skills/lsp-refactoring in your project.

What does Lsp Refactoring need to run?

Going by SKILL.md and its folder, Lsp Refactoring needs the command-line tools its instructions call (git, go, tsc, npx, mypy and cargo). Our summary lists: Python 3; Node.js.

Does Lsp Refactoring access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Lsp Refactoring safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Lsp Refactoring use?

Lsp Refactoring is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Lsp Refactoring use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Lsp Refactoring?

Skills that share tags, products or a category with Lsp Refactoring: Dev (npc-live/clawfirm, 156 stars), Solid (ramziddin/solid-skills, 606 stars), Ast Grep (BiFangKNT/mtga, 1.2k stars) and Lsp Code Analysis (lsp-client/lsp-skill, 118 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Lsp Refactoring?

ArabelaTso (a GitHub user) maintains it in ArabelaTso/Skills-4-SE, which has 253 GitHub stars. The repository holds 170 skills in this directory. The repository was last updated on August 21, 2026.

Source: ArabelaTso/Skills-4-SE on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Lsp Refactoring

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

LSP Refactoring

When to Use This Skill

What This Skill Does

Phase 1: Analysis — Understand Before Changing

Phase 2: Plan — Design the Transformation

Phase 3: Execute — Apply Changes Safely

Phase 4: Verify — TDD Confirmation

Approach by Language

Anti-Patterns

Example

Files

Compare with similar skills

Similar skills

More from ArabelaTso/Skills-4-SE

Related

Questions about Lsp Refactoring