python-uv

name	python-uv
description	This skill should be used when the user asks to "set up a Python project with uv", "manage dependencies with uv", "create a uv project", "use uv for Python package management", or needs guidance on uv workflows, pyproject.toml configuration, lockfiles, and development dependency groups.

Python UV Project Management

Provides workflows and best practices for managing Python projects using uv — Astral's fast Python package and project manager.

Project Initialization

Create a new project with uv init:

# Named project in new directory
uv init my-project
cd my-project

# Initialize in current directory
uv init

Generated structure:

my-project/
├── .gitignore
├── .python-version
├── README.md
├── main.py
└── pyproject.toml

After the first uv run, uv sync, or uv lock, uv creates:

my-project/
├── .venv/
├── .python-version
├── README.md
├── main.py
├── pyproject.toml
└── uv.lock

Run the project immediately after init:

uv run main.py

uv auto-creates and syncs the virtual environment on every uv run invocation.

Core File Roles

File	Purpose	Commit?
pyproject.toml	Broad requirements, project metadata	Yes
uv.lock	Exact resolved versions, cross-platform	Yes