# Uv Package Management Assistant

> python's package managing Use when this capability is needed.

- Skill: `tomevault-io/uv-package-management-assistant` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/uv-package-management-assistant`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/uv-package-management-assistant/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/uv-package-management-assistant

---


# uv Package Management Assistant

## Quick start
- Use `uv` for all Python dependency tasks; do not use `pip`, `pip-tools`, or `poetry`.
- Add or upgrade with `uv add <package>`; remove with `uv remove <package>`.
- Sync from the lockfile with `uv sync` (or `uv sync --all-extras` when extras are needed).
- Run scripts with the right env using `uv run <script.py>` and manage script-specific deps via `uv add/remove --script`.
- See `references/uv_rules.md` for full command guidance and script metadata examples.

## Workflow
1) **Manage project dependencies**  
   - Add/upgrade: `uv add <package>`  
   - Remove: `uv remove <package>`  
   - Resync from lock: `uv sync` (or `uv sync --all-extras` to include optional deps for development).  

2) **Run apps and scripts**  
   - Execute with `uv run <script.py>` to ensure dependencies are resolved.  
   - Manage script-only deps with `uv add --script <script.py> <package>` or `uv remove --script <script.py> <package>`.  

3) **Inline script metadata**  
   - Optionally define script requirements inline (see reference).  
   - Reinstall script deps from lock with `uv sync --script <script.py>`.  

4) **Do not**  
   - Avoid `pip install`, `pip-tools`, `poetry`, or mypy's install-missing-libraries prompts. Stick to `uv`.  

## Reference
- `references/uv_rules.md`: allowed commands, examples, and script metadata template.

---
> Source: [dmitriiweb/extract-emails](https://github.com/dmitriiweb/extract-emails) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-22 -->