LSP Management Skill

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:

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 in the project root.

Basic Structure:

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

Required Fields:

Optional Fields:

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

Integration with Existing Infrastructure

Relationship to audit-lsp

The audit-lsp command validates existing .lsp.json configurations. This skill provides:

• 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 command creates/​updates .lsp.json configurations. This skill provides:

• 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

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