Agent skill

LSP Symbol Navigation Guide

by weave-os in weave-os/router

Shows when to answer a code question through a real language server instead of grep, covering definitions, references, hover, outlines, and errors.

Apache-2.0Auto-check passedDevelopment

Install LSP Symbol Navigation Guide

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

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

GitHub CLI
$ gh skill install weave-os/router lsp-guide --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/weave-os/router.git skills-src && mkdir -p .claude/skills && cp -r skills-src/install/pi-router/skills/lsp-guide .claude/skills/lsp-guide && 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/

Facts

Skill name
lsp-guide
GitHub stars
5.6k
Token cost
~794 tokens
SKILL.md length
406 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
Apache-2.0

At a glance

Shows when to answer a code question through a real language server instead of grep, covering definitions, references, hover, outlines, and errors.

  • Works in 2 steps: Locate the declaration: rg -n --column… → {"operation": "references", "path": "",…
  • Finding every place a function or variable is actually used in code
  • SKILL.md covers Operations, Recipes and Behavior worth knowing
  • Calls rg

What it does

This skill is a recipe guide for an lsp tool that answers semantic questions about a symbol — where it's defined, every place it's used, its type and docs, a file's outline, or its current errors — by querying a language server for Go, TypeScript, JavaScript, Python, or Rust. It is explicit that a plain text search is not a references answer, since it includes comments and strings and misses aliased imports.

Each operation needs a line and column pointing at the identifier, and for finding every usage the suggested path is locating the declaration first, then querying references at that exact position. It also flags that the first query in a workspace is slow while the server indexes, that results are capped, and that an unsupported file type returns advice text rather than a hard error.

When your agent uses it

  • Finding every place a function or variable is actually used in code
  • Checking what broke in a file immediately after an edit
  • Getting a file's outline before reading all of it

Example prompts

  • “Where is the getUserById function defined, and what calls it?”
  • “Show me the outline of this file before I read the whole thing.”
  • “Check for errors in this file after my last edit.”

Requirements

  • A workspace with a language server available for the target language

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Locate the declaration: rg -n --column '\bX\b' (the --column output is
  2. {"operation": "references", "path": "", "line": , "column": }.

What it can do on your machine

Read from SKILL.md and the folder at commit bc6f7fb. 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:

    • rg

    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.

Context cost

LSP Symbol Navigation Guide loads about 794 tokens when it runs. Until then it costs about 98 tokens; SKILL.md has 406 words of instructions outside code blocks.

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

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 weave-os/router at commit bc6f7fb, republished under its Apache-2.0 licence (© weave-os). 406 words, ~794 tokens.

Download SKILL.mdSave it as .claude/skills/lsp-guide/SKILL.md (or your agent's skills folder).
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

OperationAnswersNeeds
definitionwhere the symbol at a position is definedpath, line, column
referencesevery place the symbol at a position is usedpath, line, column
hovertype signature + docs for the symbol at a positionpath, line, column
documentSymbolthe outline (types, functions, methods) of one filepath
diagnosticscompiler/type errors and warnings for one filepath

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.

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

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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in install/pi-router/skills/lsp-guide of weave-os/router.

Open the folder on GitHubat commit bc6f7fb

Compare with similar skills

LSP Symbol Navigation Guide 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 Symbol Navigation Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
LSP Symbol Navigation Guide this skillweave-os/router5.6k—~794Automated safety check: PassApache-2.0
CodeScope Codebase Graph AnalysisQwenLM/qwen-code28k1 repos~9.3kAutomated safety check: PassApache-2.0
Codegraph QAQwenLM/qwen-code-examples143—~4.3kAutomated safety check: PassNone
Code Explainermergisi/awesome-openclaw-agents4k—~283Automated safety check: PassMIT
Failure Oriented InstrumentationArabelaTso/Skills-4-SE253—~2.1kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Answers questions about code structure, history, bugs and PR risk using a CodeScope knowledge graph and semantic index built from the repository.

    28k GitHub starsUsed in 1 repo~9.3k tokens
    DevelopmentAuto-check passed
  • Codegraph QA

    QwenLM/qwen-code-examples

    Use CodeScope to analyze any indexed codebase via its graph database (neug) and vector index (zvec).

    143 GitHub stars~4.3k tokensUpdated 4 mo ago
    DevelopmentAuto-check passed
  • Code Explainer

    mergisi/awesome-openclaw-agents

    Explains a pasted code snippet in plain English, returning the detected language, a one-sentence summary, how it works and one practical tip.

    4k GitHub stars~283 tokensUpdated 12 days ago
    DevelopmentAuto-check passed
  • Failure Oriented Instrumentation

    ArabelaTso/Skills-4-SE

    Selectively instruments code to capture runtime data for debugging failures and bugs.

    253 GitHub stars~2.1k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Measures a code port between languages or frameworks with jscpd's function-level comparison, porting tests before code and tracking what is left unmatched.

    6.4k GitHub stars~5k tokensUpdated today
    DevelopmentAuto-check passed

More from weave-os/router

All 19 skills in this repo
  • Stands up the Weave model router in Docker Compose and drives it with claude -p against a real or mocked upstream to reproduce and verify routing and streaming behavior.

    5.6k GitHub stars~3.1k tokensUpdated today
    Auto-check: notes
  • Local test harness for the Weave router: a docker compose stack plus codex exec runs that confirm how Codex requests are routed, translated and marked.

    5.6k GitHub stars~4.7k tokensUpdated today
    Auto-check: notes
  • PR Merge Ready

    weave-os/router

    Works through every review comment on a pull request in one pass, fixes what it can, escalates human decisions and keeps CI churn to a single push.

    5.6k GitHub stars~10k tokensUpdated today
    Auto-check passed
  • Correlates a Claude Code session's local transcript with a model router's production cloud logs to explain why a specific response rendered the way it did.

    5.6k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Installs a language server such as gopls, typescript-language-server, pyright or rust-analyzer and, with explicit confirmation, its underlying toolchain so the lsp tool can use it.

    5.6k GitHub stars~745 tokensUpdated today
    Auto-check: notes
  • Correlates a Codex CLI session's local transcript with a model router's production logs to explain why a reply rendered the way it did.

    5.6k GitHub stars~4.5k tokensUpdated today
    Auto-check: warnings

Categories

Questions about LSP Symbol Navigation Guide

What does LSP Symbol Navigation Guide do?

Shows when to answer a code question through a real language server instead of grep, covering definitions, references, hover, outlines, and errors. This skill is a recipe guide for an lsp tool that answers semantic questions about a symbol — where it's defined, every place it's used, its type and docs, a file's outline, or its current errors — by querying a language server for Go, TypeScript, JavaScript, Python, or Rust. It is explicit that a plain text search is not a references answer, since it includes comments and strings and misses aliased imports.

When should I use LSP Symbol Navigation Guide?

LSP Symbol Navigation Guide fits situations like: finding every place a function or variable is actually used in code; checking what broke in a file immediately after an edit; getting a file's outline before reading all of it.

How do I install LSP Symbol Navigation Guide in Claude Code?

Run `npx skills add weave-os/router --skill lsp-guide -a claude-code`. Or copy the skill folder (install/pi-router/skills/lsp-guide in weave-os/router) into .claude/skills/lsp-guide in your project. Claude Code loads it when a task matches its description.

How do I install LSP Symbol Navigation Guide in Codex?

Run `npx skills add weave-os/router --skill lsp-guide -a codex`. Or copy the skill folder (install/pi-router/skills/lsp-guide in weave-os/router) into .agents/skills/lsp-guide in your project. Codex loads it when a task matches its description.

Can I use LSP Symbol Navigation Guide 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 weave-os/router --skill lsp-guide -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-guide, .gemini/skills/lsp-guide, .github/skills/lsp-guide and .opencode/skills/lsp-guide in your project.

What does LSP Symbol Navigation Guide need to run?

Going by SKILL.md and its folder, LSP Symbol Navigation Guide needs the command-line tools its instructions call (rg). Our summary lists: A workspace with a language server available for the target language.

Does LSP Symbol Navigation Guide access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is LSP Symbol Navigation Guide 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 Symbol Navigation Guide use?

LSP Symbol Navigation Guide 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 Symbol Navigation Guide use?

About 794 tokens (SKILL.md is roughly 3.2k 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 Symbol Navigation Guide?

Skills that share tags, products or a category with LSP Symbol Navigation Guide: CodeScope Codebase Graph Analysis (QwenLM/qwen-code, 28k stars), Codegraph QA (QwenLM/qwen-code-examples, 143 stars), Code Explainer (mergisi/awesome-openclaw-agents, 4k stars) and Failure Oriented Instrumentation (ArabelaTso/Skills-4-SE, 253 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains LSP Symbol Navigation Guide?

weave-os (a GitHub organization) maintains it in weave-os/router, which has 5,579 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 9, 2026.

Source: weave-os/router on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.