environment-triage
Environment Triage diagnoses Python dependency and import failures caused by mismatched interpreter versions between system Python and the active uv or venv environment. Use this skill when package installations appear successful but imports fail or optional dependencies are skipped, by verifying the actual interpreter version, checking .python-version pinning, and confirming packages are installed in the correct environment context rather than assuming system Python state.
git clone --depth 1 https://github.com/parcadei/Continuous-Claude-v3 /tmp/environment-triage && cp -r /tmp/environment-triage/.claude/skills/environment-triage ~/.claude/skills/environment-triageSKILL.md
# 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 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: ```bash 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
Security vulnerability analysis and testing
Build Python agents using Agentica SDK - spawn agents, implement agentic functions, multi-agent orchestration
Unit and integration test execution and validation
Feature planning, design documentation, AND integration planning
End-to-end and acceptance test execution
Analyze Claude Code sessions using Braintrust logs
Session analysis, precedent lookup, and learning extraction
Query the artifact index for precedent and guidance