microsoft/vscode-python-environments

cross-platform-paths

Critical patterns for cross-platform path handling in this VS Code extension. Windows vs POSIX path bugs are the #1 source of issues. Use this skill when reviewing or writing path-related code.

generate-snapshot

Generate a codebase health snapshot for technical debt tracking and planning. Analyzes git history, code complexity, debt markers, and dependencies to identify hotspots and refactoring priorities.

python-manager-discovery

Environment manager-specific discovery patterns and known issues. Use when working on or reviewing environment discovery code for conda, poetry, pipenv, pyenv, or venv.

run-pre-commit-checks

Run the mandatory pre-commit checks before committing code. Includes lint, type checking, and unit tests. MUST be run before every commit.

settings-precedence

VS Code settings precedence rules and common pitfalls. Essential for any code that reads or writes settings. Covers getConfiguration scope, inspect() vs get(), and multi-workspace handling.

debug-failing-test

Debug a failing test using an iterative logging approach, then clean up and document the learning.

run-e2e-tests

Run E2E tests to verify complete user workflows like environment discovery, creation, and selection. Use this before releases or after major changes.

run-integration-tests

Run integration tests to verify that extension components work together correctly. Use this after modifying component interactions or event handling.

run-smoke-tests

Run smoke tests to verify extension functionality in a real VS Code environment. Use this when checking if basic features work after changes.