uv-package-manager Skill for Claude Code: Python Projects with uv

uv-package-manager makes Claude use uv for Python projects: virtual environments, dependencies, lockfiles and Python versions.

Installs: 15.5K; on skills.sh
Stars: 42.1K; on GitHub
Files: 1; besides SKILL.md
Updated: Oct 2026; last repo commit

uv-package-manager is a reference skill from wshobson's agents collection. It teaches Claude the uv commands for creating projects, adding and removing dependencies, running code, locking versions and installing Python interpreters.

It loads when you set up a Python project or manage dependencies. The SKILL.md has 11 numbered patterns plus an install section, and says how to migrate from requirements.txt or poetry. references/advanced-patterns.md adds monorepo, CI, Docker and troubleshooting patterns.

Claude runs real commands on your machine when it follows the skill. Those commands install packages and Python versions, so review them first.

Good for

Python developers moving from pip, pip-tools or poetry to uv
Developers speeding up CI builds and Docker images
Teams managing Python monorepos with lockfiles

Install uv-package-manager

Claude Code

Copy this prompt.

Install the uv-package-manager skill in Claude Code. Run this command:

/plugin marketplace add wshobson/agents
/plugin install python-development@claude-code-workflows

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Pick one route. The plugin routes install the whole python-development plugin: 3 agents, 1 command and 16 skills (counted from the plugin folder in the repo tree, which has no hooks or MCP config files). The skills-only routes install just this skill, with no agents or commands.

From the project README. Source.

What's in the skill

When it loads

Master the uv package manager for fast Python dependency management, virtual environments, and modern Python project workflows. Use when setting up Python projects, managing dependencies, or optimizing Python development workflows with uv.

Sections in SKILL.md

When to Use This Skill
Core Concepts
1. What is uv?
2. Key Features
3. UV vs Traditional Tools
Installation
Quick Install
Verify Installation
Quick Start
Create a New Project
Install Dependencies
Virtual Environment Management
Pattern 1: Creating Virtual Environments
Pattern 2: Activating Virtual Environments
Pattern 3: Using uv run
Package Management

Key facts

License (per GitHub): MIT
Author: wshobson (repo owner)
Repository: wshobson/agents, folder plugins/python-development/skills/uv-package-manager
Installs on skills.sh: 15,510 as of 2026-11-02
Repo stars: 42,081 as of 2026-11-02 (whole repo)
Last repo commit: 2026-10-30
Files in the skill folder: 2 files including SKILL.md
skills.sh audits: Gen Agent Trust Hub: fail; Socket: pass; Snyk: pass

What it includes

Install uv with Homebrew, Cargo or WinGet
The SKILL.md lists brew install uv, cargo install --locked uv and a winget command, and links the official guide.
Runs code · Installation
uv init, uv add, uv sync
Create a project, add packages and dev dependencies, install from requirements.txt or pyproject.toml.
Runs code · Quick start
uv venv, activation, uv run
Create environments with a chosen Python version, activate them, or skip activation with uv run.
Runs code · Pattern 1-3: Virtual environments
Add, remove and upgrade packages
uv add with constraints, git sources and editable local paths, uv remove, and uv sync --upgrade.
Runs code · Pattern 4-6: Dependencies
uv lock and its flags
Generate, update and partially upgrade uv.lock.
Runs code · Pattern 7: Locking
Install and pin interpreters
uv python install for one or more versions, and setting the version for a project.
Runs code · Pattern 8-9: Python versions
pyproject.toml setup and migration
A pyproject.toml example, migrating from requirements.txt or poetry, and exporting back to requirements.txt.
Runs code · Pattern 10-11: Project configuration
Monorepo, CI, Docker, troubleshooting
Workspaces, a GitHub Actions workflow, single and multi-stage Dockerfiles that copy uv from an image, and offline or limited-job installs.
Runs code · references/advanced-patterns.md

From the official docs

Permissions

Low risk

Following this skill makes Claude run uv commands that install packages and Python versions and rewrite pyproject.toml and uv.lock. Approve each command and review the diff.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It runs installs on your machine
uv add, uv sync and uv python install download and install packages and interpreters. Approve each command and check the lockfile diff.
It can install the uv tool itself
The Installation section lists brew, cargo and winget commands. Install uv yourself if you prefer to pick the method.
The reference file clears uv's cache
references/advanced-patterns.md includes uv cache clean in its performance and troubleshooting sections. It affects every uv project on the machine, so run it yourself if you want it.

Technical details

Talks to	Python package index and interpreter downloads when uv commands run. ghcr.io image in the Docker example
Scopes	Your Python project files Package indexes and Python downloads, through uv

Questions

What does the uv-package-manager skill do?

It makes Claude use the uv package manager for Python work. Claude creates projects and virtual environments, adds dependencies, locks versions and installs Python versions with uv commands.

How do I install it?

Use the install box above and pick one route. The skills CLI route installs only this skill. The plugin route installs the whole python-development plugin, which adds 3 agents, 1 command and 16 skills (counted from the repo tree). You also need uv itself: the skill's Installation section lists Homebrew, Cargo and WinGet routes.

Why use uv over pip or poetry?

The skill's comparison says uv is 10-100x faster than pip and faster and lighter than poetry. It is the skill author's claim in the SKILL.md, not something we measured.

Does it need an API key?

No. The skill names no key and bundles no scripts.

Is it safe?

It bundles no scripts, but the commands it teaches install packages, download Python versions, clear uv's cache and write files such as pyproject.toml and uv.lock. Read each command before you approve it and use a project you can reset.

Can it migrate my poetry or requirements.txt project?

Yes. Pattern 11 shows uv add -r requirements.txt, running uv sync in a project that already has a pyproject.toml, and exporting back with uv pip freeze.

Information

updated Nov 2, 2026

Repository: wshobson/agents
Folder: plugins/python-development/skills/uv-package-manager

wshobson/agents skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

uv-package-manager SKILL.md · github.com
wshobson/agents README · github.com
plugin.json · github.com
advanced-patterns.md · github.com