# Uv Priority

> Prioritize uv over pip for all Python package management and execution commands in Claude Code.

- Skill: `nordeim-openclaw-curated-skills/uv-priority` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add nordeim-openclaw-curated-skills/uv-priority`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nordeim-openclaw-curated-skills/uv-priority/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: nordeim (https://skillmd.com/u/nordeim-openclaw-curated-skills)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/nordeim-openclaw-curated-skills/uv-priority

---


# UV Priority

Always prioritize `uv` over `pip` for any Python command in Claude Code.

## When to Use

Use when:
- Any task involving Python (scripts, libs, projects, dbt)
- Installing dependencies
- Creating/maintaining virtual environments
- Running Python commands
- Running tests

Do not use when:
- Tasks without Python

## Command Substitutions

Always use uv instead of pip:
- `uv pip install` → `uv add`
- `python -m venv` → `uv venv`
- `pip install -r requirements.txt` → `uv pip install -r requirements.txt` or migrate to `pyproject.toml`
- `python script.py` → `uv run script.py`
- `pytest` → `uv run pytest`
- `dbt run` → `uv run dbt run`
- `python -m pytest` → `uv run pytest`
- `pip list` → `uv pip list`
- `pip freeze` → `uv pip freeze`

## Priority

`uv` is ALWAYS the first option for any Python package management or execution.

## Fallback

If `uv` is not available on the system:
1. Suggest installing `uv` first: `curl -LsSf https://astral.sh/uv/install.sh | sh` (Linux/macOS) or `powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"` (Windows)
2. If installation is not possible, suggest using `pip` as fallback
3. Ask for user confirmation before proceeding with `pip`

## Flexibility

This is a flexible skill - adapt to context and use good judgment. The priority is `uv`, but use appropriate alternatives when genuinely necessary (e.g., system constraints, specific CI environments where `uv` cannot be installed).

## Notes

- Models often already use `uv`; this skill reinforces `uv` as the priority
- No instructions about `pyproject.toml` structure included
- Assume project already has `pyproject.toml` configured or `uv` will manage it
- Mention pytest should be run with `uv run pytest` when applicable