uv-package-manager

Manages Python dependencies, virtual environments, and project workflows using the uv package manager.

1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/Clay-HHK/claude-skills --skill uv-package-manager-clay-hhk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: uv-package-manager
Source: https://github.com/Clay-HHK/claude-skills/tree/main/uv-package-manager
Command: npx skills add https://github.com/Clay-HHK/claude-skills --skill uv-package-manager-clay-hhk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Slow Python package installation, inconsistent dependency resolution, and fragmented tooling across pip, pip-tools, and poetry make Python project setup tedious and error-prone. This Skill provides comprehensive guidance for using uv, a Rust-based package manager that installs dependencies 10-100x faster than pip while handling virtual environments, Python versions, and lockfiles in one tool. ## Core Features & Use Cases - Dependency Management: Add, remove, upgrade, and lock packages with uv add, uv lock, and uv sync for reproducible builds via uv.lock. - Environment & Python Management: Create virtual environments with uv venv, install Python versions with uv python install, and run commands without activation using uv run. - CI/CD & Docker Integration: Configure GitHub Actions workflows and multi-stage Dockerfiles with frozen lockfile installs for consistent builds. - Use Case: You are starting a new FastAPI project. Use this Skill to initialize the project with uv init, pin Python 3.12, add fastapi and uvicorn, set up pytest and ruff as dev dependencies, and configure a CI pipeline that runs tests with uv sync --frozen. ## Quick Start Ask the AI to initialize a new Python project with uv, add your required dependencies, and set up a reproducible lockfile workflow.

Frequently Asked Questions about uv-package-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install Python packages with uv?▼

Use `uv add package-name` to add a dependency to pyproject.toml and install it, or `uv pip install package-name` for pip-compatible installation. Run `uv sync` to install all dependencies from an existing pyproject.toml or lockfile.

How do I migrate from pip and requirements.txt to uv?▼

Run `uv init` in your project, then `uv add -r requirements.txt` to import existing dependencies into pyproject.toml. Alternatively, use `uv venv` and `uv pip install -r requirements.txt` for a drop-in pip replacement without changing project structure.

What is the difference between uv and poetry?▼

uv is significantly faster than poetry and less opinionated about project structure. Both use pyproject.toml, so existing poetry projects can switch by running `uv sync` directly, since uv reads the standard [project] section.

Does uv work in Docker and CI/CD pipelines?▼

Yes, uv provides an official Docker image (ghcr.io/astral-sh/uv) and the astral-sh/setup-uv GitHub Action. Use `uv sync --frozen` in CI to install exact locked versions for reproducible builds.

How do I create a virtual environment with a specific Python version using uv?▼

Run `uv venv --python 3.12` to create a virtual environment with a specific version. If that Python version is not installed, first run `uv python install 3.12`, then pin it project-wide with `uv python pin 3.12`.

Why is my uv lockfile out of sync with pyproject.toml?▼

The lockfile becomes stale when dependencies in pyproject.toml change without relocking. Run `uv lock` to regenerate it, `uv lock --check` to verify sync status, or `uv lock --upgrade` to update all packages to their latest compatible versions.