python-uv

The uv skill provides comprehensive expertise for utilizing Astral's uv, a high-performance Python package and project manager written in Rust. Designed to be 10-100x faster than traditional pip workflows, this skill enables Claude to assist with the entire lifecycle of Python development, from initial project scaffolding to production Docker deployments and CI/CD pipeline integration.

• Streamlined project initialization with uv init, automatically generating standard project structures including pyproject.toml and .python-version files.

• Advanced dependency management workflows for adding, removing, and syncing packages, replacing pip, pip-tools, and poetry with a unified, high-speed interface.

• Efficient runtime execution using uv run, which eliminates the need to manually activate virtual environments by automatically handling environment synchronization.

• Python version management capabilities, allowing users to install, list, and switch between multiple Python versions seamlessly with the uv python command.

• Native tool management that replaces pipx for installing, running, and upgrading CLI tools like ruff, black, and pytest in isolated environments.

• Compatibility with legacy systems through the uv pip interface, enabling direct migration of existing requirements.txt files into a modern uv-managed structure.

• Use this skill whenever you need to start a new project, optimize existing dependency chains, or resolve complex Python environment issues.

• It is highly recommended for CI/CD setups where reproducible builds and locked dependencies are critical to production stability.

• Claude can use this skill to generate optimized Dockerfiles for production, ensuring minimal image sizes and fast build times by leveraging uv's efficient caching and sync mechanisms.

• Always favor uv run for executing scripts and tools as it ensures the environment is current and avoids common pitfalls related to manual venv activation.

• Remember that uv creates a deterministic environment via the uv.lock file; ensure this file is always committed to version control for project portability.

• When migrating from older tools, the skill provides specific workflows to import requirements and transition smoothly to the modern uv configuration.