claude-mods/skills/python-env/SKILL.md

---

name: python-env

description: Fast Python environment management with uv. 10-100x faster than pip for installs, venv creation, and dependency resolution. Triggers on: install Python package, create venv, pip install, setup Python project, manage dependencies, Python environment.

Python Environment

Purpose

Manage Python packages and virtual environments with extreme speed using uv (Rust-based, 10-100x faster than pip).

Tools

Tool	Command	Use For
uv	uv pip install pkg	Fast package installation
uv	uv venv	Virtual environment creation
uv	uv pip compile	Lock file generation

Usage Examples

Package Installation

# Install package (10-100x faster than pip)
uv pip install requests

# Install multiple packages
uv pip install flask sqlalchemy pytest

# Install from requirements.txt
uv pip install -r requirements.txt

# Install with extras
uv pip install "fastapi[all]"

# Install specific version
uv pip install "django>=4.0,<5.0"

Virtual Environments

# Create venv (fastest venv creation)
uv venv

# Create with specific Python version
uv venv --python 3.11

# Activate (still uses standard activation)
# Windows: .venv\Scripts\activate
# Unix: source .venv/bin/activate

Dependency Management

# Generate lockfile from requirements.in
uv pip compile requirements.in -o requirements.txt

# Sync environment to lockfile
uv pip sync requirements.txt

# Show installed packages
uv pip list

# Uninstall package
uv pip uninstall requests

Run Commands

# Run script in project environment
uv run python script.py

# Run with specific Python
uv run --python 3.11 python script.py

When to Use

• Installing Python packages (always prefer over pip)
• Creating virtual environments
• Setting up new Python projects
• Managing dependencies
• Syncing development environments