How do I install the Uv skill?

Run npx skillmds@latest add knoopx/uv in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Uv?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

knoopx (@knoopx) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Uv by knoopx — Agent Skill

Name: Uv
Author: knoopx

File contents

uv

Fast Python package and project manager — 10-100x faster than pip with built-in virtual environment management.

Project Setup

uv init my-app             # App project
uv init my-lib --lib      # Library project
uv init --script script.py # Standalone script
uv python pin 3.11        # Pin Python version for the project

Managing Dependencies

uv add requests           # Add a dependency
uv add --dev pytest       # Add dev dependency
uv add --optional ml scikit-learn  # Add optional group
uv remove requests        # Remove a dependency
uv lock                   # Update lockfile only
uv export > requirements.txt  # Export to pip format

Commit uv.lock for reproducibility.

Syncing Environments

uv sync                   # Install all dependencies
uv sync --no-dev          # Skip dev dependencies
uv sync --all-extras      # Include all optional groups
uv sync --refresh         # Recreate venv from scratch
uv sync --locked          # Fail if lockfile would change (CI-friendly)

Running Code

uv run python script.py   # Run a script with project deps available
uv run -m pytest          # Run a module
uv run --with requests script.py  # Add a one-off dependency
uv run --extra ml train.py  # Use optional dependencies
uv run --env-file .env script.py  # Load environment variables

uv run handles virtual environment creation automatically.

Installing Tools

uvx ruff check .          # Run a tool once without installing
uv tool install ruff      # Install globally for reuse
uv tool list              # List installed tools
uv tool upgrade ruff      # Upgrade a tool

Tools are isolated from project dependencies.

Building & Publishing

uv build                 # Build source and wheel distributions
uv publish               # Publish to PyPI

Formatting

uv format                # Format Python code
uv format --check        # Check without changes

Project Versioning

uv version 1.2.3         # Set version
uv version --bump major  # Bump major version

Typical CI Workflow

uv sync --locked           # Install deps from lockfile
uv run pytest              # Run tests
uv run ruff check .        # Lint

---name: uvdescription: Initializes Python projects, manages dependencies, pins Python versions, and runs scripts with uv. Use when adding/removing packages, syncing environments, running tools with uvx, or building distributions.---# uvFast Python package and project manager — 10-100x faster than pip with built-in virtual environment management.## Project Setup```bashuv init my-app # App projectuv init my-lib --lib # Library projectuv init --script script.py # Standalone scriptuv python pin 3.11 # Pin Python version for the project```## Managing Dependencies```bashuv add requests # Add a dependencyuv add --dev pytest # Add dev dependencyuv add --optional ml scikit-learn # Add optional groupuv remove requests # Remove a dependencyuv lock # Update lockfile onlyuv export > requirements.txt # Export to pip format```Commit `uv.lock` for reproducibility.## Syncing Environments```bashuv sync # Install all dependenciesuv sync --no-dev # Skip dev dependenciesuv sync --all-extras # Include all optional groupsuv sync --refresh # Recreate venv from scratchuv sync --locked # Fail if lockfile would change (CI-friendly)```## Running Code```bashuv run python script.py # Run a script with project deps availableuv run -m pytest # Run a moduleuv run --with requests script.py # Add a one-off dependencyuv run --extra ml train.py # Use optional dependenciesuv run --env-file .env script.py # Load environment variables````uv run` handles virtual environment creation automatically.## Installing Tools```bashuvx ruff check . # Run a tool once without installinguv tool install ruff # Install globally for reuseuv tool list # List installed toolsuv tool upgrade ruff # Upgrade a tool```Tools are isolated from project dependencies.## Building & Publishing```bashuv build # Build source and wheel distributionsuv publish # Publish to PyPI```## Formatting```bashuv format # Format Python codeuv format --check # Check without changes```## Project Versioning```bashuv version 1.2.3 # Set versionuv version --bump major # Bump major version```## Typical CI Workflow```bashuv sync --locked # Install deps from lockfileuv run pytest # Run testsuv run ruff check . # Lint```

Frequently asked questions

Uv