File contents 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
# What uv ACTUALLY uses
uv run python --version
# What's pinned (this controls uv)
cat .python-version
# Confirm package is installed
uv pip show <package>
# Confirm import works in uv context
uv run python -c "import <package>; print(<package>.__version__)"
Common Fix
If optional deps require Python 3.12+ but .python-version is 3.11:
echo "3.13" > .python-version
rm -rf .venv && uv venv && uv sync --all-extras
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: parcadei/Continuous-Claude-v3 → .claude/skills/environment-triage/SKILL.md
1 ---
2 name: environment-triage
3 description: "Environment Triage"
4 category: general-purpose
5 source_repo: parcadei/Continuous-Claude-v3
6 source_path: ".claude/skills/environment-triage/SKILL.md"
7 source_url: https://github.com/parcadei/Continuous-Claude-v3/blob/HEAD/.claude/skills/environment-triage/SKILL.md
8 metadata:
9 source: https://skillmd.com/skills/parcadei/environment-triage
10 ---
11
12
13 # Environment Triage
14
15 When `uv sync` or `pip install` behaves unexpectedly, check the actual interpreter.
16
17 ## Pattern
18
19 System Python is not authoritative if uv/venv selects a different interpreter.
20
21 ## DO
22
23 ```bash
24 # What uv ACTUALLY uses
25 uv run python --version
26
27 # What's pinned (this controls uv)
28 cat .python-version
29
30 # Confirm package is installed
31 uv pip show <package>
32
33 # Confirm import works in uv context
34 uv run python -c "import <package>; print(<package>.__version__)"
35 ```
36
37 ## Common Fix
38
39 If optional deps require Python 3.12+ but .python-version is 3.11:
40
41 ```bash
42 echo "3.13" > .python-version
43 rm -rf .venv && uv venv && uv sync --all-extras
44 ```
45
46 ## DON'T
47
48 - Trust `python3 --version` when using uv
49 - Assume install succeeded without verifying import
50 - Debug further before checking interpreter version
51
52 ## Source Sessions
53
54 - 2243c067: symbolica-agentica skipped due to `python_version >= 3.12` marker, but uv was using 3.11
55 - 4784f390: agentica import failures traced to wrong interpreter
56
57 ---
58
59 **Source:** [`parcadei/Continuous-Claude-v3`](https://github.com/parcadei/Continuous-Claude-v3) → `.claude/skills/environment-triage/SKILL.md`
parcadei/Continuous-Claude-v3 commit 9c977408d4
Frequently asked questions How do I install the Environment Triage skill? Run npx get-skill add parcadei/environment-triage in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Environment Triage skill do? Environment Triage It is listed under Coding & Dev Tools on SkillMD.
Is Environment Triage safe to use? This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Environment Triage? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Environment Triage free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Environment Triage? parcadei (@parcadei) published this skill. Their other Agent Skills are listed on their SkillMD profile.