skills.rest
scooter-lacroix
scooter-lacroixCOMMUNITY
Explore all skills by this author →
Website𝕏@scooter_lacroixGitHub

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
One-click install
npx skills add https://github.com/scooter-lacroix/Maestro --skill environment-triage
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
zhuangbiaoweizhuangbiaowei
2

test_script_type

Run Python scripts and capture their output and arguments.

Community
Basic
parcadeiparcadei
3.9k

environment-triage

Diagnose Python environment inconsistencies by verifying interpreters and packages in uv or venv.

Community
Basic
mvandermeulenmvandermeulen
2

uv-package-manager

Manage Python dependencies, virtual environments, and interpreter versions with uv.

Community
Intermediate
tizeetizee
2

uv-script

Create and run standalone Python scripts with inline dependency metadata using uv.

Community
Advanced