К основному содержанию
скилл CX Codex

lsp-guide — скилл для Claude Code: что делает и как установить

Скилл lsp-guide учит агента спрашивать языковой сервер, где определён символ, где он используется и что сломалось после правки, вместо поиска по тексту.

Apache-2.0 ★ 5 622 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add weave-os/router --skill lsp-guide -a claude-code
Открыть на GitHub

Что делает lsp-guide

Скилл даёт агенту готовые рецепты для инструмента lsp — пять операций: definition, references, hover, documentSymbol и diagnostics. Работают они через настоящий языковой сервер для Go, TypeScript/JavaScript, Python и Rust, поэтому импорты, алиасы и типы разворачиваются, а не совпадают по буквам.

Вызов требует координат: path, line и column, нумерация с единицы, колонка ставится на первый символ идентификатора. Пути считаются от рабочей директории. Поиск использований идёт в два шага: сначала объявление через rg -n --column или documentSymbol, потом references.

Первый запрос в новой рабочей области ждёт индексации — до минуты в большом репозитории, и после таймаута его стоит повторить один раз. Список ссылок ограничен, по умолчанию 100. Для файла, который сервер не поддерживает, вернётся текст с советом; недостающий сервер ставится через lsp_enable с согласия пользователя. Внутри dispatch-субагентов запросы тоже работают.

Какие задачи решает

  • найти все места вызова функции, а не текстовые совпадения
  • посмотреть сигнатуру и доккомментарий, не открывая файл определения
  • получить оглавление файла перед чтением длинного модуля
  • узнать, что сломалось после правки, по диагностике сервера
  • различить одноимённые символы из разных пакетов

Примеры запросов агенту

  • Где определён <symbol> и где он ещё используется? Смотри через языковой сервер, не грепом.
  • Прогони диагностику по <file> после моей правки.
  • Дай оглавление <file>, а потом сигнатуру и доккомментарий у <symbol>.

Как установить lsp-guide

1Через Skills CLI (Vercel)

npx skills add weave-os/router --skill lsp-guide -a claude-code

2Вручную: положить файлы

~/.claude/skills/lsp-guide/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/lsp-guide/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о lsp-guide

Как установить lsp-guide в Claude Code?

Выполните npx skills add weave-os/router --skill lsp-guide -a claude-code. Файл скилла окажется по пути ~/.claude/skills/lsp-guide/SKILL.md.

Что делает lsp-guide?

Он даёт агенту рецепты для инструмента lsp: переход к определению, поиск использований, сигнатура с доками, оглавление файла и диагностика компилятора.

С какими языками это работает?

С Go, TypeScript/JavaScript, Python и Rust — через соответствующий языковой сервер. Для остальных файлов остаётся поиск по тексту.

Исходный текст

SKILL.md · Apache-2.0
---
name: lsp-guide
description: Recipes for the lsp tool — resolving where a symbol is defined, every place it is used, type signatures and docs, file outlines, and compiler/type errors through a real language server (Go, TypeScript/JavaScript, Python, Rust). Use when navigating or explaining code by symbol, finding callers or usages, checking what broke after an edit, or deciding between lsp and text search.
---

# Using the lsp tool

The `lsp` tool answers *semantic* questions through the language's own server:
it resolves through imports, types, and aliases, where grep only matches text.
Reach for it whenever the question is about a **symbol**; keep grep for plain
strings, comments, and file types no server supports.

## Operations

| Operation | Answers | Needs |
|---|---|---|
| `definition` | where the symbol at a position is defined | `path`, `line`, `column` |
| `references` | every place the symbol at a position is used | `path`, `line`, `column` |
| `hover` | type signature + docs for the symbol at a position | `path`, `line`, `column` |
| `documentSymbol` | the outline (types, functions, methods) of one file | `path` |
| `diagnostics` | compiler/type errors and warnings for one file | `path` |

Positions are 1-based, and `column` must point **at the identifier** (its first
character works). All paths resolve against the working directory.

## Recipes

**"Where is X defined?"** — from any usage site of X:
`{"operation": "definition", "path": "<file>", "line": <L>, "column": <C>}`.
Don't know a usage site? Find one first (see next recipe's step 1).

**"Everywhere X is used"** — two steps, always:

1. Locate the declaration: `rg -n --column '\bX\b'` (the `--column` output is
   exactly the coordinate the next call needs), or `documentSymbol` when you
   already know the file.
2. `{"operation": "references", "path": "<decl file>", "line": <L>, "column": <C>}`.

A grep hit list is **not** a references answer: it includes comments and
strings, misses aliased imports, and can't distinguish same-named symbols.
Step 2 is what makes the answer authoritative.

**"What is this / what's its signature?"** — `hover` at the symbol. Prefer it
over reading the definition file when you only need the type or doc comment.

**"What's in this file?"** — `documentSymbol` before reading a large file; jump
straight to the line the outline gives you.

**"Did my edit break anything here?"** — `diagnostics` on the file after
editing. It reports the server's current analysis of the saved file.

## Behavior worth knowing

- **First query per workspace is slow** (the server indexes — up to a minute
  in a big repo). Later queries on that workspace are fast; don't give up
  after one timeout, retry once.
- **References are capped** (default 100, header says how many exist).
- **Unsupported file type or missing server** returns advice text, not an
  error — fall back to grep for that file. A missing server can be installed
  with the user's consent via `lsp_enable` (see the install-lsps skill for
  toolchain prerequisites).
- Works inside dispatch subagents too (they share the parent's warm servers),
  so symbol lookups are safe to fan out.

© weave-os · Apache-2.0 · weave-os/router

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
lsp-edit-export blackwell-systems Скилл lsp-edit-export для Claude Code и Codex выстраивает безопасный сценарий изменения публичных API. Сначала находит все места вызова символа и запрашивает подтверждение, предотвращая скрытые поломки. CX Codex +1 ★ 182звёзд репо lsp-code-analysis lsp-client Скилл lsp-code-analysis для Claude Code анализирует код через Language Server Protocol: находит определения и ссылки, показывает структуру файлов и предварительный результат рефакторинга. CX Codex +1 958установок lsp-understand blackwell-systems Скилл lsp-understand для Claude Code строит карту зависимостей по отдельному символу или файлу. Читает типы, реализации, иерархию вызовов до двух уровней и внешние ссылки. CX Codex +1 ★ 182звёзд репо lsp-setup официальный github Скилл lsp-setup для GitHub Copilot устанавливает языковой сервер и настраивает LSP в Copilot CLI. Настройка нужна для перехода к определению и просмотра ссылок на символ. CX Codex +1 1 100установок rust-call-graph actionbook Скилл rust-call-graph строит граф вызовов функций Rust через LSP: кто вызывает функцию и что вызывает она. Пригодится при разборе чужого кода и оценке последствий правок. CX Codex +1 3 600установок rust-analyzer-lsp официальный Anthropic Плагин rust-analyzer-lsp подключает языковой сервер rust-analyzer к Claude, чтобы агент видел структуру Rust-кода и анализировал его. ★ 47 914звёзд репо

Из того же набора20

Весь набор →
router-session Скилл router-session для Codex печатает идентификатор сессии, который Weave Router использует в телеметрии и логах. Идентификатор используют для поиска запуска в панели роутера. CX Codex +1 ★ 5 622звёзд репо force-parent Скилл force-parent закрепляет текущую ветку разговора за выбранной моделью через Weave Router. Субагенты при этом маршрутизируются сами — пригодится, когда одна задача требует другой модели. CX Codex +1 ★ 5 622звёзд репо models Команда models показывает список доступных моделей в Weave Router и переключает их прямо из чата без перезапуска роутера. CX Codex +1 ★ 5 622звёзд репо router-models Скилл router-models для Claude Code и Codex показывает модели Weave Router, меняет их статус и порядок предпочтения. CX Codex +1 ★ 5 622звёзд репо debug-claude-session Скилл debug-claude-session находит локальный транскрипт сессии Claude Code и сопоставляет его с облачными логами роутера по времени и модели. Помогает понять, почему клиент отобразил пустой или битый блок. CX Codex +1 ★ 5 622звёзд репо test-claude-locally Скилл test-claude-locally для Claude Code запускает локальный Weave router в Docker Compose и проверяет маршрутизацию через claude -p. Воспроизводит баги и проверяет модели. CX Codex +1 ★ 5 622звёзд репо test-codex-locally Скилл test-codex-locally поднимает роутер Weave в docker compose и гоняет его через codex exec в отдельном CODEX_HOME: воспроизводит баги маршрутизации, проверяет маркеры и /force-model. CX Codex +1 ★ 5 622звёзд репо pr-merge-ready Скилл pr-merge-ready закрывает замечания к пулл-реквесту за один проход: группирует правки по файлам, валидирует код один раз и не спамит комментариями в тредах. CX Codex +1 ★ 5 622звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой