Configure a Language Server (LSP) for a specific language so editor/agent tooling β diagnostics, go-to-definition, find-references, rename β works. Use when you need to: configure LSP, lsp setup, set up or install a language server, fix 'no LSP server configured' / 'server not
Installs just this skill. Get the whole plugin for auto-invocation.
β‘ How it fires
How this skill gets triggered: by you, by Claude, or both.
Fires itselfClaude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/lsp-setup
ποΈ Context preview
The summary Claude sees to decide when to auto-load this skill.
Configure a Language Server (LSP) for a specific language so editor/agent tooling β diagnostics, go-to-definition, find-references, rename β works. Use when you need to: configure LSP, lsp setup, set up or install a language server, fix 'no LSP server configured' / 'server not
---name: lsp-setup
description: "Configure a Language Server (LSP) for a specific language so editor/agent tooling β diagnostics, go-to-definition, find-references, rename β works. Use when you need to: configure LSP, lsp setup, set up or install a language server, fix 'no LSP server configured' / 'server not installed', choose between servers (basedpyright vs pyright vs ty vs ruff), or wire .codex/lsp-client.json / .opencode/lsp.json. μΈμ΄μλ² μ€μ . Routes by file extension to references/<language>/README.md for the exact builtin server, per-OS install commands (macOS/Linux/Windows), config snippets for both config files, initialization options, alternatives, and troubleshooting. Ships scripts: detect-lsp.ts (scan a project for languages + each server's install/config status) and verify-lsp.ts (run a real diagnostics roundtrip). Covers typescript, python, go, rust, c/c++, java, kotlin, c#/razor, swift, ruby, php, dart, elixir, zig, lua, bash, yaml, terraform, haskell, julia."
---# LSP Setup
Configure the right Language Server for a project so the `lsp` MCP tools
(`diagnostics`, `goto_definition`, `find_references`, `symbols`, `rename`)
actually work. This skill is an index: detect what a project needs, install the
server, write the config, then verify with a real roundtrip.
The list of servers we ship as **builtin** is the source of truth in
`packages/lsp-tools-mcp/src/lsp/server-definitions.ts` (`BUILTIN_SERVERS` +
`LSP_INSTALL_HINTS`). The per-language references below mirror it.
---## PHASE 0 β LANGUAGE GATE (run first)
Identify the language from the file extension, then **read the matching
"disabled": false // set true to turn a server off
}
}
}
```
Rules enforced by `config-loader.ts`:
- In a **project** config (`.codex/lsp-client.json`, `.opencode/lsp.json`) an
entry whose id is a **builtin** server inherits `command` automatically β you
only override `extensions` / `priority` / `initialization`. A non-builtin id
in a project config is **ignored**.
- To define a **fully custom** (non-builtin) server with its own `command`, put
it in the **user** config (`~/.codex/lsp-client.json`, or the path set by
`LSP_TOOLS_MCP_USER_CONFIG`), where `command` + `extensions` are honored.
- Project entries win over user entries; both win over builtin defaults.
Each language reference gives a ready-to-paste snippet.
### 4. Verify
Run a real diagnostics roundtrip against a source file. This spawns the server,
opens the file, requests diagnostics, and reports `OK`/`FAIL`:
```bash
bun scripts/verify-lsp.ts <path/to/file.ext>
bun scripts/verify-lsp.ts <file> --timeout=90000
```
`OK` = the server started and answered. `FAIL: language server not installed`
= go back to step 2. Other `FAIL` text carries the server/startup error.
`SKIP` = the engine source could not be located; run from inside the omo
repo/worktree, or call the `lsp` MCP `diagnostics` tool directly.
---
## Scripts
| Script | Purpose |
|---|---|
| `scripts/detect-lsp.ts` | Scan a directory; per detected language report server id, install status, install hint, config status. `--json` for machine output. |
| `scripts/verify-lsp.ts` | Real LSP diagnostics roundtrip for one file via the `lsp-tools-mcp` engine; `OK`/`FAIL`/`SKIP` + exit code 0/1/3. |
| `scripts/lsp-server-table.ts` | Embedded snapshot of the primary builtin server per language (mirrors `server-definitions.ts`). |
Run with [Bun](https://bun.sh): `curl -fsSL https://bun.sh/install | bash`.
