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.