environment-triage

Diagnose Python environment inconsistencies by verifying interpreters and package installations.

8|1|Updated Jan 4, 2026

Search Tags:#pip #python #uv #environment #triage #interpreter

Ready to run

npx skills add https://github.com/scooter-lacroix/Maestro --skill environment-triage

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: environment-triage
Source: https://github.com/scooter-lacroix/Maestro/tree/main/maestro/skills/environment-triage
Command: npx skills add https://github.com/scooter-lacroix/Maestro --skill environment-triage

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve unexpected behavior in Python environments, particularly when package installations or imports fail due to interpreter mismatches or incorrect configurations.

Core Features & Use Cases

Interpreter Verification: Identifies the exact Python interpreter being used by tools like uv.
Configuration Check: Verifies pinned Python versions against the active environment.
Package Validation: Confirms if a specific package is installed and importable within the active environment.
Use Case: When uv sync fails with errors related to Python version compatibility, this Skill provides commands to pinpoint the discrepancy and offers a solution to update the environment.

Quick Start

Run uv run python --version to see what uv is actually using.

Frequently Asked Questions about environment-triage

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

FAQPage Schema

Why does uv sync fail with a Python version compatibility error?▼

uv sync fails when the active Python interpreter mismatches the pinned version. Verify the environment by running `uv run python --version` to identify the exact interpreter uv is using and resolve the discrepancy.

How do I check which Python interpreter pip is actually using?▼

Check the active Python interpreter by executing diagnostic commands in the shell. This Skill verifies the active interpreter against pinned versions to pinpoint environment inconsistencies causing pip or uv installation failures.

How do I confirm if a Python package is installed and importable in my current environment?▼

Confirm package installation by validating imports within the active environment. This Skill provides shell commands to check if a specific package is installed and importable, resolving unexpected behavior when package imports fail.

What is the best way to debug Python environment inconsistencies when package installations fail?▼

Debug Python environment inconsistencies by verifying the active interpreter against pinned versions and confirming package installations. This Skill diagnoses interpreter mismatches or incorrect configurations that cause installation failures.

Do I need direct shell access to diagnose Python environment issues with uv and pip?▼

Direct shell access is required to execute diagnostic commands and modify environment configurations. This Skill verifies pinned Python versions and validates package installations by running commands directly in the terminal.

Why does my Python environment use the wrong interpreter when running uv commands?▼

Your Python environment uses the wrong interpreter due to configuration mismatches. Run `uv run python --version` to verify the active interpreter against pinned versions and identify the exact discrepancy causing the error.