# Uv Package Management Assistant

> Manages Python dependencies and scripts using uv only. Use when adding, upgrading, removing, or syncing Python packages, or when running Python scripts and managing their dependencies.

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

---


# uv Package Management Assistant

## Core Rules

- Use `uv` for **all** Python dependency management.
- **Never** use `pip`, `pip-tools`, `poetry`, or IDE prompts to install Python packages.
- Prefer lockfile-driven installs and syncs to keep environments reproducible.

## Common Tasks

### 1. Manage project dependencies

- **Add or upgrade a package**:
  - `uv add PACKAGE`
- **Remove a package**:
  - `uv remove PACKAGE`
- **Sync environment from lockfile**:
  - `uv sync`
  - `uv sync --all-extras` to include optional/dev extras.

### 2. Run apps and scripts

- **Run a module or script with the correct environment**:
  - `uv run python main.py`
  - `uv run python -m PACKAGE.module`

### 3. Script-specific dependencies

- **Add dependencies for a specific script**:
  - `uv add --script path/to/script.py PACKAGE`
- **Remove dependencies for a specific script**:
  - `uv remove --script path/to/script.py PACKAGE`
- **Sync script deps from lockfile**:
  - `uv sync --script path/to/script.py`

## When to Apply This Skill

Automatically use these rules whenever:

- The user wants to install, upgrade, or remove a Python package.
- The project already uses `uv` (`uv.lock`, `pyproject.toml` mentioning `uv`).
- The user asks about Python env, dependencies, or running Python scripts in this repo.

If a command suggestion would normally involve `pip` or `poetry`, rewrite it into the equivalent `uv` command instead.