LSP Management Skill

🚨 MANDATORY: Invoke docs-management First

STOP - Before providing ANY response about LSP configuration:

1. INVOKE

   docs-management

   skill for Claude Code LSP documentation
2. QUERY for the user's specific LSP topic
3. BASE all responses on official documentation + this skill's knowledge base

Skipping this step results in outdated or incorrect information.

⚠️ EXPERIMENTAL: Claude Code LSP Status

LSP support in Claude Code is experimental and has known issues. Key points:

ENABLE_LSP_TOOL=1

.lsp.json

lspServers

See troubleshooting.md for version-specific issues and workarounds.

Overview

Central authority for Language Server Protocol (LSP) configuration in Claude Code. This skill provides:

• LSP server recommendations by language/technology
• Configuration patterns for

  .lsp.json

  files
• Installation guides for each recommended server
• Troubleshooting for common LSP issues

Architecture: Keyword registry + curated knowledge base. Delegates to docs-management for official Claude Code LSP documentation.

When to Use This Skill

Keywords: LSP, language server, language-server-protocol, code intelligence, hover, go-to-definition, find-references, diagnostics, pyright, typescript-language-server, gopls, rust-analyzer, csharp-ls, .lsp.json, LSP configuration, LSP setup, LSP troubleshooting

Use this skill when:

• Setting up LSP servers for a project
• Choosing between LSP server options for a language
• Configuring

  .lsp.json

  files
• Troubleshooting LSP issues (hover not working, diagnostics missing, etc.)
• Understanding LSP server installation requirements
• Auto-detecting needed LSPs based on project file types

Keyword Registry for docs-management Queries

Use these keywords when querying docs-management skill for official documentation:

Core Concepts

Server-Specific

Troubleshooting

Quick Decision Tree

What do you need?

1. Set up LSP for a new project → See server-database.md for recommended servers
2. Configure .lsp.json → See configuration-patterns.md for patterns
3. Install a specific LSP server → See installation-guide.md for per-server commands
4. Fix LSP issues → See troubleshooting.md for common problems
5. Understand Claude Code LSP support → Query docs-management: "LSP configuration Claude Code"

LSP Server Recommendations (Quick Reference)

For detailed recommendations with alternatives and trade-offs, see server-database.md.

.lsp.json Configuration Format

Claude Code reads LSP configuration from

.lsp.json

Basic Structure:

{
  "server-name": {
    "command": "server-executable",
    "args": ["--stdio"],
    "extensionToLanguage": {
      ".ext": "language-id"
    },
    "restartOnCrash": true,
    "maxRestarts": 3
  }
}

Required Fields:

command

args

["--stdio"]

extensionToLanguage

Optional Fields:

restartOnCrash

true

maxRestarts

3

For complete patterns and examples, see configuration-patterns.md.

Auto-Detection Strategy

When auto-detecting needed LSPs for a project:

1. Scan for file extensions using Glob patterns
2. Match extensions to languages using the mapping table below
3. Recommend servers from server-database.md

Extension to Language Mapping

.py

.pyi

.ts

.tsx

.js

.jsx

.go

.rs

.cs

.csx

.c

.h

.cpp

.hpp

.cc

.java

.rb

.php

.lua

.yaml

.yml

.json

Integration with Existing Infrastructure

Relationship to audit-lsp

The

audit-lsp

.lsp.json

• Server recommendations that audit-lsp can validate against
• Configuration patterns that audit-lsp checks for compliance
• Troubleshooting guidance when audit-lsp finds issues

Relationship to setup-lsp

The

setup-lsp

.lsp.json

• Server database for recommendations
• Installation guides for chosen servers
• Configuration templates for generation

Test Scenarios

These scenarios should activate this skill:

1. Direct activation: "Use the lsp-management skill to recommend a Python LSP"
2. Setup question: "How do I set up LSP for my TypeScript project?"
3. Configuration question: "What should my .lsp.json look like for Go?"
4. Troubleshooting: "My hover tooltips aren't working in Python files"
5. Comparison: "Should I use pyright or pylsp for Python?"

Related Skills

lspServers

References

Detailed guides (load on-demand):

• Server Database - Curated recommendations by language
• Configuration Patterns - Common .lsp.json patterns
• Installation Guide - Per-server installation commands
• Troubleshooting - Common issues and fixes

Official Documentation (via docs-management):

• Query: "LSP configuration Claude Code"
• Query: ".lsp.json format"

Version History

• v1.0.0 (2026-01-11): Initial release
  • LSP server recommendations for 12+ languages
  • Configuration pattern documentation
  • Installation guides per server
  • Troubleshooting guide
  • Integration with audit-lsp and setup-lsp

Last Updated

Date: 2026-01-11 Model: claude-opus-4-5-20251101