lsp

Name: lsp
Author: tomevault-io

AI Community

Repo stars 0
Author repo skills-registry

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: Multi-language code navigation via persistent LSP daemons. Supports Python (pyright), TypeScript/JS, Rust, Go, C/C++, Bash, Java…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “Supported Languages”, “Setup”, “Prerequisites”, “Installation”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name lsp directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “Supported Languages / Setup / Prerequisites” before expanding.

Boundaries And Review

Dependencies: It usually needs no extra API key, so start with a small validation task.
Permissions: Declared permissions include read / env-read; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

LSP Code Navigation

Multi-language LSP client that manages per-language background daemons. Auto-detects the language from file extension and routes queries to the correct server. Each server lazy-starts on first use and idles out after 5 minutes of inactivity.

Use this instead of grep/read when you need to:

Find where something is defined
Find all usages of a symbol
Get type signatures or docstrings
List all classes/functions in a file
Check for type errors before running code
Search for a symbol across an entire workspace

Supported Languages

Language	Server	Extensions	Install
Python	`pyright-langserver`	.py, .pyi, .pyx	`npm install -g pyright`
TypeScript/JS	`typescript-language-server`	.ts, .tsx, .js, .jsx, .mjs, .cjs	`npm install -g typescript-language-server typescript`
Rust	`rust-analyzer`	.rs	`rustup component add rust-analyzer`
Go	`gopls`	.go	`go install golang.org/x/tools/gopls@latest`
C/C++	`clangd`	.c, .h, .cpp, .cc, .hpp	`apt install clangd` or `brew install llvm`
Bash	`bash-language-server`	.sh, .bash, .zsh	`npm install -g bash-language-server`
Java	`jdtls`	.java	eclipse.jdt.ls
CSS	`vscode-css-language-server`	.css, .scss, .less	`npm install -g vscode-langservers-extracted`
HTML	`vscode-html-language-server`	.html, .htm	`npm install -g vscode-langservers-extracted`
JSON	`vscode-json-language-server`	.json, .jsonc	`npm install -g vscode-langservers-extracted`

Only install the servers you need. The skill auto-detects which are available and reports helpful install commands for missing ones.

Setup

Prerequisites

Python 3.10+ (for the client script itself -- stdlib only, no pip deps)
At least one language server installed (see table above)

Installation

The skill includes a Python script at {baseDir}/scripts/lsp-query.py. This is the LSP client -- it manages background daemons and handles all queries.

To make it callable as lsp-query from anywhere, symlink it into your PATH:

ln -sf {baseDir}/scripts/lsp-query.py /usr/local/bin/lsp-query
# or:
ln -sf {baseDir}/scripts/lsp-query.py ~/.npm-global/bin/lsp-query

Alternatively, invoke it directly:

{baseDir}/scripts/lsp-query.py <command> [args...]

Configuration

Set LSP_WORKSPACE to the repo root before querying. If unset, defaults to the git root or cwd.

Commands

All line and column numbers are 1-indexed (human-friendly, matching editor display).

Go to Definition

lsp-query definition /path/to/file.py <line> <col>

Find References

lsp-query references /path/to/file.py <line> <col>

Hover (Type Info)

lsp-query hover /path/to/file.py <line> <col>

Document Symbols

lsp-query symbols /path/to/file.py

Workspace Symbol Search

lsp-query workspace-symbols "ClassName"

Diagnostics

lsp-query diagnostics /path/to/file.py

Completions

lsp-query completions /path/to/file.py <line> <col>

Signature Help

lsp-query signature /path/to/file.py <line> <col>

Rename Preview

lsp-query rename /path/to/file.py <line> <col> new_name

Server Management

lsp-query languages                    # Show all supported languages + install status
lsp-query servers                      # List running language daemons
lsp-query shutdown                     # Stop all daemons
lsp-query shutdown python              # Stop just the Python daemon

What's Included

{baseDir}/
├── SKILL.md              # This file
└── scripts/
    └── lsp-query.py      # Python script -- multi-language LSP client + daemon manager

lsp-query.py is a self-contained Python script (~850 lines, stdlib only, no pip dependencies). It:

Forks a single background daemon process on first use
The daemon lazy-starts language servers as needed (e.g., pyright for .py, typescript-language-server for .ts)
Communicates with the daemon over a Unix socket (~/.cache/lsp-query/daemon.sock)
Translates CLI commands into LSP JSON-RPC requests and prints human-readable results
Each language server auto-stops after 5 minutes idle; the daemon itself stops when all servers are idle

Environment Variables

Variable	Default	Description
`LSP_WORKSPACE`	git root or cwd	Workspace root for LSP servers
`LSP_SERVER`	auto per language	Override server command for ALL languages
`LSP_LANG`	auto from extension	Force a specific language (bypass detection)
`LSP_TIMEOUT`	`300`	Server idle timeout in seconds
`LSP_SOCK`	`~/.cache/lsp-query/daemon.sock`	Unix socket path

Examples

export LSP_WORKSPACE=/path/to/repo

# Python
lsp-query symbols src/model.py
lsp-query hover src/model.py 42 10
lsp-query references src/model.py 42 10

# TypeScript (auto-detected from .ts extension)
lsp-query symbols src/index.ts
lsp-query definition src/app.tsx 15 8

# Rust
lsp-query symbols src/main.rs
lsp-query diagnostics src/lib.rs

# Check what's available
lsp-query languages
lsp-query servers

Troubleshooting

"Server not found for X": The language server binary isn't installed. The error message includes the install command.
"could not connect to LSP daemon": Daemon failed to start. Verify Python 3.10+ is available.
Import errors in diagnostics: Expected when packages aren't installed in the current Python environment. These resolve on machines with the correct venv.
Stale results: Run lsp-query shutdown to restart all servers fresh.
Slow first query per language: Each server takes 1-2 seconds to cold-start. Subsequent queries to the same language are ~200ms.
Wrong language detected: Use LSP_LANG=rust lsp-query symbols myfile to force.

Source: AgentWorkers/skills — distributed by TomeVault.

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: AI
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 88 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @tomevault-io · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Plug-and-play
External API key: No requirement detected
Detected OS requirements: macOS · Linux · Windows
Runtime requirements: Python >=3.10
Detected file/system behavior: Read-only
Env read
Detected network behavior: Local-only
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview lsp-tomevault-io.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# LSP Code Navigation

Multi-language LSP client that manages per-language background daemons. Auto-detects the language from file extension and routes queries to the correct server. Each server lazy-starts on first use and idles out after 5 minutes of inactivity.

**Use this instead of grep/read when you need to:**
- Find where something is defined
- Find all usages of a symbol
- Get type signatures or docstrings
- List all classes/functions in a file
- Check for type errors before running code
- Search for a symbol across an entire workspace

## Supported Languages

| Language | Server | Extensions | Install |
|----------|--------|------------|---------|
| Python | `pyright-langserver` | .py, .pyi, .pyx | `npm install -g pyright` |
| TypeScript/JS | `typescript-language-server` | .ts, .tsx, .js, .jsx, .mjs, .cjs | `npm install -g typescript-language-server typescript` |
| Rust | `rust-analyzer` | .rs | `rustup component add rust-analyzer` |
| Go | `gopls` | .go | `go install golang.org/x/tools/gopls@latest` |
| C/C++ | `clangd` | .c, .h, .cpp, .cc, .hpp | `apt install clangd` or `brew install llvm` |
| Bash | `bash-language-server` | .sh, .bash, .zsh | `npm install -g bash-language-server` |
| Java | `jdtls` | .java | [eclipse.jdt.ls](https://github.com/eclipse-jdtls/eclipse.jdt.ls) |
| CSS | `vscode-css-language-server` | .css, .scss, .less | `npm install -g vscode-langservers-extracted` |
| HTML | `vscode-html-language-server` | .html, .htm | `npm install -g vscode-langservers-extracted` |
| JSON | `vscode-json-language-server` | .json, .jsonc | `npm install -g vscode-langservers-extracted` |

Only install the servers you need. The skill auto-detects which are available and reports helpful install commands for missing ones.

## Setup

### Prerequisites

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> Supported Languages → Setup → Prerequisites → Installation → Configuration → Commands
terms    -> Use this instead of grep/read when you need to · 1-indexed · "Server not found for X" · "could not connect to LSP daemon" · Import errors in diagnostics · Stale results · Slow first query per language · Wrong language detected
files/cmd -> pyright-langserver · npm install -g pyright · typescript-language-server · npm install -g typescript-language-server typescript · rust-analyzer · rustup component add rust-analyzer · gopls · go install golang.org/x/tools/gopls@latest
body sha256 -> c9033f9e38a3