New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Official agent skill

Uv

by astral-sh in astral-sh/claude-code-plugins

Guide for using uv, the Python package and project manager. An agent skill from astral-sh/claude-code-plugins.

OfficialApache-2.0Auto-check passedProduct & Project Management

Install Uv

skills CLI
$ npx skills add astral-sh/claude-code-plugins --skill uv -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install astral-sh/claude-code-plugins uv --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/astral-sh/claude-code-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/astral/skills/uv .claude/skills/uv && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
uv
GitHub stars
313
Used in
2 other repos
Token cost
~980 tokens
SKILL.md length
230 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
Apache-2.0

At a glance

Guide for using uv, the Python package and project manager. An agent skill from astral-sh/claude-code-plugins.

  • Tasks that involve Project management
  • SKILL.md covers When to use uv, Choosing the right workflow, Migrating from other tools and Common patterns, plus 1 more section
  • Calls uv, pyenv and pipx

What it does

Uv is an agent skill from astral-sh/claude-code-plugins, published by the product's own GitHub organization. Guide for using uv, the Python package and project manager. Use this when working with Python projects, scripts, packages, or tools.

Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management, covering Project management. It works with Python and Ruff. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Project management

Example prompts

  • “/uv”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit f3ce88a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv
    • pyenv
    • pipx
    • pip
    • uvx
    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.astral.sh

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Uv loads about 980 tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 230 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~980

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from astral-sh/claude-code-plugins at commit f3ce88a, republished under its Apache-2.0 licence (© astral-sh). 230 words, ~980 tokens.

Download SKILL.mdSave it as .claude/skills/uv/SKILL.md (or your agent's skills folder).
name
uv
description
Guide for using uv, the Python package and project manager. Use this when working with Python projects, scripts, packages, or tools.

uv

uv is an extremely fast Python package and project manager. It replaces pip, pip-tools, pipx, pyenv, virtualenv, poetry, etc.

When to use uv

Always use uv for Python work, especially if you see:

  • The uv.lock file
  • uv headers in requirements* files, e.g., "This file was autogenerated by uv"

Don't use uv in projects managed by other tools:

  • Poetry projects (identifiable by poetry.lock file)
  • PDM projects (identifiable by pdm.lock file)

Choosing the right workflow

Scripts

Use when: Running single Python files and standalone scripts.

Key commands:

bash
uv run script.py                      # Run a script
uv run --with requests script.py      # Run with additional packages
uv add --script script.py requests    # Add dependencies inline to the script
Projects

Use when: There is a pyproject.toml or uv.lock

Key commands:

bash
uv init                   # Create new project
uv add requests           # Add dependency
uv remove requests        # Remove dependency
uv sync                   # Install from lockfile
uv run <command>          # Run commands in environment
uv run python -c ""       # Run Python in project environment
uv run -p 3.12 <command>  # Run with specific Python version
Tools

Use when: Running command-line tools (e.g., ruff, ty, pytest) without installation.

Key commands:

bash
uvx <tool> <args>            # Run a tool without installation
uvx <tool>@<version> <args>  # Run a specific version of a tool

Important:

  • uvx runs tools from PyPI by package name. This can be unsafe - only run well-known tools.
  • Only use uv tool install only when specifically requested by the user.
Pip interface

Use when: Legacy workflows with requirements.txt or manual environment management, no uv.lock present.

Key commands:

bash
uv venv
uv pip install -r requirements.txt
uv pip compile requirements.in -o requirements.txt
uv pip sync requirements.txt

# Platform independent resolution
uv pip compile --universal requirements.in -o requirements.txt

Important:

  • Don't use the pip interface unless clearly needed.
  • Don't introduce new requirements.txt files.
  • Prefer uv init for new projects.

Migrating from other tools

pyenv → uv python
bash
pyenv install 3.12       → uv python install 3.12
pyenv versions           → uv python list --only-installed
pyenv local 3.12         → uv python pin 3.12
pyenv global 3.12        → uv python install 3.12 --default
pipx → uvx
bash
pipx run ruff            → uvx ruff
pipx install ruff        → uv tool install ruff
pipx upgrade ruff        → uv tool upgrade ruff
pipx list                → uv tool list
pip and pip-tools → uv pip
bash
pip install package      → uv pip install package
pip install -r req.txt   → uv pip install -r req.txt
pip freeze               → uv pip freeze
pip-compile req.in       → uv pip compile req.in
pip-sync req.txt         → uv pip sync req.txt
virtualenv .venv         → uv venv

Common patterns

Don't use pip in uv projects
bash
# Bad
pip install requests

# Good
uv add requests
Don't run python directly
bash
# Bad
python script.py

# Good
uv run script.py
bash
# Bad
python -c "..."

# Good
uv run python -c "..."
bash
# Bad
python3.12 -c "..."

# Good
uvx python@3.12 -c "..."
Don't manually manage environments in uv projects
bash
# Bad
python -m venv .venv
source .venv/bin/activate

# Good
uv run <command>

Documentation

For detailed information, read the official documentation:

The documentation links to specific pages for each of these workflows.

© astral-sh, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/astral/skills/uv of astral-sh/claude-code-plugins.

Open the folder on GitHubat commit f3ce88a

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in astral-sh/claude-code-plugins, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Uv next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Uv compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Uv this skillastral-sh/claude-code-plugins3132 repos~980Automated safety check: PassApache-2.0
Milestone CheckKATO-Hiro/AtCoderClans141—~166Automated safety check: PassMIT
Gh Read Inspectoreclipse-rdf4j/rdf4j420—~950Automated safety check: PassBSD-3-Clause
Using Uvlexler/skill-factory239—~367Automated safety check: PassApache-2.0
Agile Coachborghei/Claude-Skills886—~1.2kAutomated safety check: PassMIT
Review LoopOpenCyphal/pycyphal142—~817Automated safety check: PassMIT

Similar skills

  • Milestone Check

    KATO-Hiro/AtCoderClans

    Detect users who newly crossed a rating threshold (2000/2400/2800/3200) in a given AtCoder contest, validate whether they are listed on the site's blog pages, and report candidates for addition.

    141 GitHub stars~166 tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

  • Gh Read Inspector

    eclipse-rdf4j/rdf4j

    Retrieve GitHub issues, pull requests, and milestones with read-only, whitelisted gh commands only.

    420 GitHub stars~950 tokensUpdated today
    Product & Project ManagementAuto-check passed

  • Using Uv

    lexler/skill-factory

    Python package and project management with UV. An agent skill from lexler/skill-factory.

    239 GitHub stars~367 tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed

  • Agile Coach

    borghei/Claude-Skills

    Expert agile coaching: framework selection, maturity assessment, retrospective facilitation, transformation roadmaps.

    886 GitHub stars~1.2k tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed

  • Review Loop

    OpenCyphal/pycyphal

    Multi-agent review/refine loop. An agent skill from OpenCyphal/pycyphal.

    142 GitHub stars~817 tokensUpdated 2 mo ago
    Testing & QAAuto-check passed

  • Minimizing Ty Ecosystem Changes

    astral-sh/ruff

    Official

    A skill your agent uses when a user says "minimize this ty ecosystem change", "reproduce this ecosystem result", "investigate a primer difference", "investigate a mypyprimer difference"…

    50k GitHub stars~4.6k tokensUpdated today
    DevelopmentAuto-check passed

More from astral-sh/claude-code-plugins

  • Ruff

    astral-sh/claude-code-plugins

    Official

    Guide for using ruff, the extremely fast Python linter and formatter.

    313 GitHub stars~992 tokensUpdated 7 mo ago
    Auto-check passed

  • Ty

    astral-sh/claude-code-plugins

    Official

    Guide for using ty, the extremely fast Python type checker and language server.

    313 GitHub stars~792 tokensUpdated 7 mo ago
    Auto-check passed

Works with

Categories

Questions about Uv

What does Uv do?

Guide for using uv, the Python package and project manager. An agent skill from astral-sh/claude-code-plugins. Uv is an agent skill from astral-sh/claude-code-plugins, published by the product's own GitHub organization. Guide for using uv, the Python package and project manager.

When should I use Uv?

Uv fits situations like: tasks that involve Project management.

How do I install Uv in Claude Code?

Run `npx skills add astral-sh/claude-code-plugins --skill uv -a claude-code`. Or copy the skill folder (plugins/astral/skills/uv in astral-sh/claude-code-plugins) into .claude/skills/uv in your project. Claude Code loads it when a task matches its description.

How do I install Uv in Codex?

Run `npx skills add astral-sh/claude-code-plugins --skill uv -a codex`. Or copy the skill folder (plugins/astral/skills/uv in astral-sh/claude-code-plugins) into .agents/skills/uv in your project. Codex loads it when a task matches its description.

Can I use Uv in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add astral-sh/claude-code-plugins --skill uv -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/uv, .gemini/skills/uv, .github/skills/uv and .opencode/skills/uv in your project.

What does Uv need to run?

Going by SKILL.md and its folder, Uv needs the command-line tools its instructions call (uv, pyenv, pipx, pip, uvx and python). Our summary lists: Python 3.

Does Uv access the network?

SKILL.md names 1 domain. As links in the text: docs.astral.sh. This is read from the text; nothing was executed.

Is Uv safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Uv use?

Uv is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Uv use?

About 980 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Uv?

Skills that share tags, products or a category with Uv: Milestone Check (KATO-Hiro/AtCoderClans, 141 stars), Gh Read Inspector (eclipse-rdf4j/rdf4j, 420 stars), Using Uv (lexler/skill-factory, 239 stars) and Agile Coach (borghei/Claude-Skills, 886 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Uv?

astral-sh (a GitHub organization, an official publisher) maintains it in astral-sh/claude-code-plugins, which has 313 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on February 27, 2026.

Source: astral-sh/claude-code-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.