uv
If the project uses uv, use this skill. Use this skill to create/manage Python projects and environments with uv, add/remove dependencies, sync a project from uv.lock, and run commands in the project environment.
- Installs
- 94
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/openhands/extensions --skill uv- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads uv automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
uv (Python)
Use uv as the default tool for Python dependency + environment management when the repo has uv.lock, mentions uv in its docs/Makefile, or already uses a .venv created by uv.
Quick decision rules
- If the repo has
uv.lockandpyproject.toml: treat it as a uv-managed project. - If the repo has only
requirements.txt: you can still useuv pipfor fast installs. - Prefer project commands (
uv add/remove/sync/run/lock) over rawpipunless the repo explicitly usesuv pip.
Installation (if needed)
Prefer a packaged install method when available. If you use the official installer, review it first (avoid blindly piping into a shell) and follow the latest instructions in the official docs.
# macOS/Linux (official installer)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell, official installer)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Common operations
Initialize a new project
uv init
# or
uv init my-project
Create / use a virtual environment
uv venv # creates .venv
# If you need a specific version, match the project's declared requirement
# (e.g., pyproject.toml / CI config), not an arbitrary latest version.
uv venv --python 3.x
# optional activation (not required for uv commands)
source .venv/bin/activate # macOS/Linux
# .venv\\Scripts\\activate # Windows
Add / remove dependencies (updates pyproject.toml and uv.lock)
uv add requests
uv add 'requests==2.31.0'
uv add -r requirements.txt
uv remove requests
Lock + sync (reproducible installs)
uv lock # (re)generate uv.lock
uv sync # create/update .venv to match uv.lock
If you pulled new changes and uv.lock changed, run uv sync.
Run commands inside the project environment
uv run python -m pytest -q
uv run python main.py
uv run ruff check .
Using uv as a fast pip replacement (requirements workflows)
uv venv
uv pip install -r requirements.txt
uv pip freeze
uv pip list
Notes / pitfalls
uvwill usually auto-detect and use.venvin the project root.- In CI/containers you may see
uv pip install --system, but prefer virtualenvs for local dev. - If a command mutates deps, prefer
uv add/remove/lock/syncsouv.lockstays correct.
FAQ
What does the uv skill do?
If the project uses uv, use this skill. Use this skill to create/manage Python projects and environments with uv, add/remove dependencies, sync a project from uv.lock, and run commands in the project environment.
How do I install uv?
Run npx skills add https://github.com/openhands/extensions --skill uv in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/uv/ (personal) or .claude/skills/uv/ (project).
Which AI agents can use uv?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is uv safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains uv?
It is published by openhands in openhands/extensions. It has 94 recorded installs.
More from openhands/extensions
ssh
openhands/extensions
Establish and manage SSH connections to remote machines, including key generation, configuration, and file transfers. Use when connecting to remote servers, executing remote commands, or transferring files via SCP.
code-review
openhands/extensions
Review code changes for material correctness, security, compatibility, and maintainability risks, grounded in the current repository and acceptance criteria.
codereview-roasted
openhands/extensions
Brutally honest code review in the style of Linus Torvalds, focusing on data structures, simplicity, and pragmatism. Use when you want critical, no-nonsense feedback that prioritizes engineering fundamentals over style preferences.
security
openhands/extensions
Security best practices for secure coding, authentication, authorization, and data protection. Use when developing features that handle sensitive data, user authentication, or require security review.
docker
openhands/extensions
Run Docker commands within a container environment, including starting the Docker daemon and managing containers. Use when building, running, or managing Docker containers and images.
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.