using-python-lsp

Navigate definitions, find references, and verify type correctness in Python projects.

2|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/mhagrelius/dotfiles --skill using-python-lsp-mhagrelius
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-python-lsp
Source: https://github.com/mhagrelius/dotfiles/tree/main/.claude/skills/using-python-lsp
Command: npx skills add https://github.com/mhagrelius/dotfiles --skill using-python-lsp-mhagrelius

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables semantic code intelligence for Python projects by leveraging the pyright-lsp plugin to understand types, symbol relationships, and inheritance, replacing brittle text searches for accurate refactoring and navigation.

Core Features & Use Cases

  • Semantic symbol navigation: go to definitions, view type information, and explore symbol relationships.
  • References and type-checking: find all usages before refactoring and detect type errors in real time.
  • Use Cases: When you need precise code understanding, safe refactoring, and fast navigation in Python codebases.

Quick Start

Enable the pyright-lsp plugin and start querying references, definitions, or types in your Python project.

Frequently Asked Questions about using-python-lsp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I navigate Python definitions and references semantically instead of text search?

Semantic code navigation in Python uses pyright-lsp to understand types and symbol relationships, replacing brittle text searches for accurate definition lookups and reference finding. Enable the plugin and start querying symbols in your Python project.

Can I check Python type correctness in real time using pyright?

Yes, type-checking with pyright-lsp detects type errors in real time by analyzing your Python project configured with pyproject.toml or pyrightconfig.json. It verifies type correctness and identifies issues as you code.

What do I need to set up before using Python LSP for code intelligence?

Python LSP requires the pyright-lsp plugin activation, a Python project configured with pyproject.toml or pyrightconfig.json, and the pyright binary installed. Ensure all three are present before querying definitions, references, or types.

When should I use semantic code intelligence over text search for Python refactoring?

Use semantic code intelligence when you need precise code understanding and safe refactoring in Python codebases. It leverages pyright to understand types, symbol relationships, and inheritance, providing accurate results where text searches would be brittle or incomplete.

Does Python LSP work with pyproject.toml or do I need a separate pyrightconfig.json?

Python LSP works with both pyproject.toml and pyrightconfig.json configurations. Either file can configure your Python project for pyright-lsp to provide semantic symbol navigation, reference finding, and type-checking.

Why does Python LSP require pyright to find all symbol references?

Finding all symbol references requires pyright because it provides the semantic understanding of types and relationships that text-based search cannot. The pyright-lsp plugin uses this to accurately locate usages before refactoring.