Lsp Refactor

What it does

When your agent uses it

• Tasks that involve Refactoring

Example prompts

• “/lsp-refactor”

Requirements

• Compatibility (from SKILL.md): Requires the agent-lsp MCP server (github.com/blackwell-systems/agent-lsp)
• Pre-approved tools (allowed-tools): mcp__lsp__blast_radius, mcp__lsp__preview_edit, mcp__lsp__simulate_chain, mcp__lsp__get_diagnostics, mcp__lsp__run_build, mcp__lsp__run_tests, mcp__lsp__get_tests_for_file, mcp__lsp__apply_edit, mcp__lsp__replace_symbol_body, mcp__lsp__open_document, mcp__lsp__format_document, Edit, Write

Workflow steps

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

1. 1Blast-Radius Analysis (inlined from lsp-impact)
2. 2Speculative Preview (inlined from lsp-safe-edit)
3. 3Apply to Disk
4. 4Build Verification (inlined from lsp-verify)
5. 5Run Affected Tests (inlined from lsp-test-correlation)

What it can do on your machine

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

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • mcp__lsp__blast_radius
  • mcp__lsp__preview_edit
  • mcp__lsp__simulate_chain
  • mcp__lsp__get_diagnostics
  • mcp__lsp__run_build
  • mcp__lsp__run_tests
  • mcp__lsp__get_tests_for_file
  • mcp__lsp__apply_edit
  • mcp__lsp__replace_symbol_body
  • mcp__lsp__open_document

  …and 3 more on the same allowed-tools line.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  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.

• Compatibility

  Requires the agent-lsp MCP server (github.com/blackwell-systems/agent-lsp)

  From compatibility in the SKILL.md frontmatter.

Context cost

Lsp Refactor loads about 2.8k tokens when it runs, and up to ~3.3k if it reads all its reference files. Until then it costs about 61 tokens; SKILL.md has 707 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~61

When it runs · the whole SKILL.md, loaded when a task matches

~2.8k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~3.3k

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

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 blackwell-systems/agent-lsp at commit 6fa5faf, republished under its MIT licence (© blackwell-systems). 707 words, ~2,756 tokens.

name

lsp-refactor

description

End-to-end safe refactor workflow — blast-radius analysis, speculative preview, apply to disk, verify build, run affected tests. Inlines lsp-impact + lsp-safe-edit + lsp-verify + lsp-test-correlation into one coordinated sequence.

allowed-tools

mcp__lsp__blast_radius, mcp__lsp__preview_edit, mcp__lsp__simulate_chain, mcp__lsp__get_diagnostics, mcp__lsp__run_build, mcp__lsp__run_tests, mcp__lsp__get_tests_for_file, mcp__lsp__apply_edit, mcp__lsp__replace_symbol_body, mcp__lsp__open_document, mcp__lsp__format_document, Edit, Write

compatibility

Requires the agent-lsp MCP server (github.com/blackwell-systems/agent-lsp)

argument-hint

[symbol-or-file] [intent]

user-invocable

true

license

MIT

metadata.required-capabilities

referencesProvider

metadata.optional-capabilities

documentFormattingProvider

mcp__lsp__blast_radius({
  "changed_files": ["/abs/path/to/file"],
  "include_transitive": false
})

High blast radius: N callers found. Proceed with refactor? [y/n]

mcp__lsp__open_document({ "file_path": "/abs/path/to/file", "language_id": "go" })
mcp__lsp__get_diagnostics({ "file_path": "/abs/path/to/file" })

mcp__lsp__preview_edit({
  "file_path": "/abs/path/to/file",
  "start_line": <N>,
  "start_column": <col>,
  "end_line": <N>,
  "end_column": <col>,
  "new_text": "<replacement text>"
})

mcp__lsp__simulate_chain({
  "workspace_root": "/abs/path/to/workspace",
  "language": "go",
  "edits": [
    {
      "file_path": "/abs/path/to/file.go",
      "start_line": <N>, "start_column": <col>,
      "end_line": <N>,   "end_column": <col>,
      "new_text": "<replacement>"
    }
    // additional dependent edits ...
  ]
})

mcp__lsp__replace_symbol_body({
  "file_path": "/abs/path/to/file",
  "symbol_path": "Package.Function",
  "new_body": "func Function() error {\n\treturn nil\n}"
})

Edit(file_path: "/abs/path/to/file", old_string: "...", new_string: "...")

mcp__lsp__format_document({ "file_path": "/abs/path/to/file" })

mcp__lsp__get_diagnostics({ "file_path": "/abs/path/to/file" })
mcp__lsp__run_build({ "workspace_root": "/abs/path/to/workspace" })

mcp__lsp__get_tests_for_file({ "file_path": "/abs/path/to/changed/file" })

mcp__lsp__run_tests({ "workspace_root": "/abs/path/to/workspace", "test_files": [...] })

## lsp-refactor Complete

### Phase 1 — Blast Radius
Affected symbols: N
Test callers: M  (list each with enclosing test function)
Non-test callers: K

### Phase 2 — Speculative Preview
[Diagnostic Diff Output Format from patterns.md]
net_delta: 0 → safe to apply

### Phase 3 — Applied
Files changed: [list]

### Phase 4 — Build Verification
Diagnostics: N errors (0 new)
Build: PASS

### Phase 5 — Test Results
Test files run: [list]
Result: PASS / FAIL

## lsp-refactor Aborted at Phase 2

### Phase 1 — Blast Radius
...

### Phase 2 — Speculative Preview
ABORTED: net_delta: +2 (errors introduced)
Errors:
- file.go:34 — undefined: NewType
- file.go:51 — cannot use int as string

Goal: rename exported function ParseConfig → ParseConfigV2 in pkg/config

Phase 1 — Blast Radius
  blast_radius(changed_files=["pkg/config/parser.go"])
  → affected_symbols: 1 (ParseConfig)
  → non_test_callers: 3 (cmd/main.go, internal/app.go, internal/loader.go)
  → test_callers: 1 (pkg/config/parser_test.go — TestParseConfig)
  → total references: 4 — within threshold, proceeding

Phase 2 — Speculative Preview
  open_document(file_path="pkg/config/parser.go")
  get_diagnostics → BEFORE: 0 errors
  simulate_chain(edits: [parser.go rename + 3 call-site updates])
  → cumulative_delta: 0 → safe to apply

Phase 3 — Applied
  Edit parser.go: func ParseConfig → func ParseConfigV2
  Edit cmd/main.go, internal/app.go, internal/loader.go: update call sites
  format_document(parser.go)

Phase 4 — Build Verification
  get_diagnostics → 0 errors
  run_build → success

Phase 5 — Test Results
  get_tests_for_file(parser.go) → pkg/config/parser_test.go
  run_tests(test_files=["pkg/config/parser_test.go"]) → PASS

## lsp-refactor Complete
...

© blackwell-systems, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/lsp-refactor of blackwell-systems/agent-lsp.

• SKILL.md
• references/patterns.md

Open the folder on GitHubat commit 6fa5faf