Diagnoses and resolves Python environment discrepancies and interpreter mismatches when using uv or pip.
The Environment Triage skill provides a systematic approach for Claude to debug Python environment issues, particularly when using modern package managers like uv. It ensures that the active interpreter matches project requirements, verifies package installations, and provides clear remediation steps for version conflicts, such as updating .python-version files. By validating the actual execution context rather than relying on system defaults, it helps developers quickly resolve 'ModuleNotFoundError' and dependency marker failures that occur during complex setups.
Key Features
01Verifies package installation status within specific virtual environments
02Detects hidden Python interpreter mismatches in uv environments
03Provides standardized verification patterns for uv and pip contexts
04Validates .python-version against dependency requirements
050 GitHub stars
06Automates environment recreation and synchronization for version upgrades
Use Cases
01Troubleshooting 'ModuleNotFoundError' after a seemingly successful package installation
02Debugging why 'uv sync' is selecting an unexpected interpreter version
03Resolving dependency failures caused by Python version requirements (e.g., 3.12+ requirements on 3.11)
