uv · harperreed — Claude Code skill: what it does, how to install
Guides your AI agent through Python workflows using uv: dependency resolution, virtualenvs, PEP 723 scripts, CI, and multistage Docker builds.
npx skills add harperreed/dotfiles --skill uv -a claude-codeWhat uv does
This skill equips coding agents with command patterns for uv instead of traditional pip or poetry setups. It covers project initialization, standalone PEP 723 scripts, and interpreter switching. It replaces multiple legacy tools at once.
It also details deployment workflows, including pinned GitHub Actions configurations and a multistage Dockerfile designed around layer caching. Without uv installed and available on your system PATH, the skill halts execution.
What it helps with
- set up reproducible Python dependencies and
uv.lock - write a multistage Dockerfile with uv layer caching
- configure GitHub Actions tests using
astral-sh/setup-uv - migrate project commands from pip, poetry, or pyenv to uv
Example prompts for the agent
- Migrate this repository dependencies from poetry to uv
- Generate a multistage Dockerfile for my app using uv sync --frozen
- Add httpx to script.py using PEP 723 metadata format
How to install uv
1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill uv -a claude-code2Manually: put the files in place
~/.claude/skills/uv/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/uv/
1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill uv -a codex2Manually: put the files in place
.agents/skills/uv/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill uv -a cursor2Manually: put the files in place
.cursor/skills/uv/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install harperreed/dotfiles uv2Manually: put the files in place
.github/skills/uv/SKILL.md1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill uv -a gemini-cli2Platform CLI
gemini skills install https://github.com/harperreed/dotfiles --path .claude/skills/uvManually: put the files in place
.devin/skills/uv/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill uv -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about uv
How to install uv in Claude Code?
Run npx skills add harperreed/dotfiles --skill uv -a claude-code. This adds the instruction file to ~/.claude/skills/uv/SKILL.md.
What does this skill do?
It provides the agent with exact workflows for managing Python projects, virtualenvs, CLI utilities, and CI pipelines through uv.
What prerequisites are required?
The uv binary must be preinstalled and accessible in your PATH. The skill checks this upfront with uv --version.
Similar skills
All skills for Backend and APIs →uv by other authors comes first.