Environment Triage

by parcadeid07ff4b06b62No license3.9K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 8 months ago

Environment Triage

Instructions onlySoftware Development

AI-generated overview

Diagnoses Python interpreter mismatches when uv or pip installs behave unexpectedly.

What it does: This skill provides a triage procedure for situations where uv sync or pip install does not behave as expected. It directs the agent to check which interpreter uv actually uses, what version is pinned in .python-version, and whether a package is installed and importable in the uv context. It also gives a common fix: updating the pinned Python version, recreating the virtual environment, and resyncing with all extras.
When to use it: Use it when uv sync or pip install produces unexpected results, when optional dependencies appear to be skipped, or when imports fail despite an apparently successful install. It is meant for Python projects managed with uv where the active interpreter may differ from the system Python.
Requirements: No scripts are shipped; it is instructions only. It assumes a project using uv and a .python-version file, with shell access to run uv commands.

Environment Triage

When uv sync or pip install behaves unexpectedly, check the actual interpreter.

Pattern

System Python is not authoritative if uv/venv selects a different interpreter.

DO

bash

# What uv ACTUALLY usesuv run python --version
# What's pinned (this controls uv)cat .python-version
# Confirm package is installeduv pip show <package>
# Confirm import works in uv contextuv run python -c "import <package>; print(<package>.__version__)"

# What uv ACTUALLY usesuv run python --version
# What's pinned (this controls uv)cat .python-version
# Confirm package is installeduv pip show <package>
# Confirm import works in uv contextuv run python -c "import <package>; print(<package>.__version__)"

Common Fix

If optional deps require Python 3.12+ but .python-version is 3.11:

DON'T

Trust python3 --version when using uv
Assume install succeeded without verifying import
Debug further before checking interpreter version

Source Sessions

2243c067: symbolica-agentica skipped due to python_version >= 3.12 marker, but uv was using 3.11
4784f390: agentica import failures traced to wrong interpreter

Source and attribution

Source:parcadei/continuous-claude-v3in.claude/skills/environment-triageat commitd07ff4b

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Environment Triage

Environment Triage

Pattern

DO

Common Fix

DON'T

Source Sessions

Source and attribution

More from parcadei/continuous-claude-v3

Tldr Stats

Wiring

Workflow Router

Validate Agent

Tour

Tldr Overview

More in Software Development

Playground

M5 Onboard

Cardputer Buddy

Web Design Guidelines

Vercel React Native Skills

Vercel React Best Practices