Menu
Troubleshooting uv (Python package manager) issues - stale cache, installation problems, package updates.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | uv-debug |
| description | Troubleshooting uv (Python package manager) issues - stale cache, installation problems, package updates. |
| Mode | Command | Updates | Best For |
|---|---|---|---|
| Production | uv tool install . | Requires reinstall | Distribution |
| Editable | uv tool install --editable . | Immediate | Active dev |
| Local | uv sync + uv run <cmd> | Immediate | Recommended |
~/.local/share/uv/tools/<package>/ # Global installs
build/ dist/ *.egg-info/ # Build artifacts (source of problems!)
Decision Tree:
Does `uv run <cmd>` work?
├─ Yes → Stale build cache → Clean and reinstall
└─ No → Code issue, not cache
The Fix (90% of cases):
rm -rf build/ dist/ *.egg-info
uv tool install --force .
Diagnostic:
which <command> # Which version running?
uv run <command> --help # Local version works?
ls -la build/ dist/ *.egg-info # Stale artifacts?
--force doesn't clean cache!# Wrong - may reuse cached wheel
uv tool install --force .
# Right - clean first
rm -rf build/ dist/ *.egg-info && uv tool install --force .
install: clean
uv tool install --force .
clean:
rm -rf build/ dist/ *.egg-info
Wheel was built before file existed.
rm -rf build/ dist/ *.egg-info
uv tool install --force .
Entry points baked into wheel at build time.
grep -A 10 "\[project.scripts\]" pyproject.toml # Verify definition
rm -rf build/ dist/ *.egg-info
uv tool install --force .
ls ~/.local/share/uv/tools/<package>/*/bin/ # Verify installed
which <command> # Where?
python3 -c "import <pkg>; print(<pkg>.__file__)" # Python path
find ~/.local/share/uv/tools -name "<package>*" # All installs
cat ~/.local/share/uv/tools/<pkg>/*/site-packages/*.pth # Editable?
# Check versions
which <cmd> && uv run <cmd> --version && <cmd> --version
# Clean rebuild
rm -rf build/ dist/ *.egg-info && uv tool install --force .
# Development mode
uv sync && uv run <command>
# Inspect
ls ~/.local/share/uv/tools/<package>/
uv pip show <package>
Use when transcribing audio files with speaker diarization. Triggers on TRANSCRIBE keyword.
Create, update, delete, and query Google Calendar events using gcallm CLI, MCP tools, or direct API calls.
Rule-based methodology for essay development. Load this index first, then load specific essay type file based on task.
Comprehensive guide for managing Claude Code snippets v2.0 - discovering locations, creating snippets from files, searching by name/pattern/description, and validating configurations. Use this skill when users want to create, search, or manage snippet configurations in their Claude Code environment. Updated for LLM-friendly interface with TTY auto-detection.
Style guide and primer for writing in Warren Zhu's voice. Use when drafting emails, essays, blog posts, technical documents, consulting deliverables, presentations, or any writing for or as Warren. Covers philosophical sensibilities, stylistic patterns, characteristic moves, tone calibration, and professional/technical writing registers. Also useful when understanding Warren's intellectual background and preferences for advising him.
Use when interacting with Harvard Canvas LMS - fetching courses, assignments, grades, submissions, modules, calendar events. Trigger with CANVAS keyword.