environment-triage
It identifies version discrepancies between local Python interpreters and uv configurations while helping to resolve package conflicts.
Install
mkdir -p .claude/skills/environment-triage && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/4085" && unzip -o skill.zip -d .claude/skills/environment-triage && rm skill.zipInstalls to .claude/skills/environment-triage
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Environment TriageKey capabilities
- →Query active Python interpreter path inside uv context
- →Compare actual versus pinned.python-version file
- →Verify package installation in current environment
- →Sync environment dependencies based on detected version discrepancies
How it works
Executes standard interpreter queries within the virtual environment shim to isolate package visibility and version mismatches.
Inputs & outputs
When to use environment-triage
- →Debugging dependency installation failures
- →Verifying active Python interpreter versions
- →Fixing virtual environment configuration
- →Syncing environment packages
About this skill
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 --versionwhen 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.12marker, but uv was using 3.11 - 4784f390: agentica import failures traced to wrong interpreter
When not to use it
- →Debugging system-wide python installations
- →Development projects not using uv/venv
- →When package errors are caused by syntax or logic rather than environment
Prerequisites
Limitations
- →Only resolves issues within the uv ecosystem
- →Requires existing environment structure to function
- →Cannot fix broken binary dependencies outside of Python's scope
How it compares
It ignores system python to specifically audit the environment created by uv, preventing common misdiagnoses based on system-wide interpreters.
Compared to similar skills
environment-triage side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| environment-triage (this skill) | 1 | 7mo | Review | Intermediate |
| replit-advanced-troubleshooting | 0 | 27d | Caution | Advanced |
| python-testing-patterns | 77 | 2mo | Review | Intermediate |
| python-performance-optimization | 27 | 2mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by parcadei
View all by parcadei →You might also like
replit-advanced-troubleshooting
jeremylongshore
Apply Replit advanced debugging techniques for hard-to-diagnose issues. Use when standard troubleshooting fails, investigating complex race conditions, or preparing evidence bundles for Replit support escalation. Trigger with phrases like "replit hard bug", "replit mystery error", "replit impossible to debug", "difficult replit issue", "replit deep debug".
python-testing-patterns
wshobson
Implement comprehensive testing strategies with pytest, fixtures, mocking, and test-driven development. Use when writing Python tests, setting up test suites, or implementing testing best practices.
python-performance-optimization
wshobson
Profile and optimize Python code using cProfile, memory profilers, and performance best practices. Use when debugging slow Python code, optimizing bottlenecks, or improving application performance.
azure-functions
aj-geddes
Create serverless functions on Azure with triggers, bindings, authentication, and monitoring. Use for event-driven computing without managing infrastructure.
python-repl
gptme
Interactive Python REPL automation with common helpers and best practices
clojure-write
metabase
Guide Clojure and ClojureScript development using REPL-driven workflow, coding conventions, and best practices. Use when writing, developing, or refactoring Clojure/ClojureScript code.