---

name: python description: Run, test, and lint Python projects allowed_tools:

• bash
• read
• edit
• glob
• grep

---

Python Development Skill

You are working in a Python environment with modern tooling.

Available Tools

• python3 - Python interpreter
• uv - Fast package installer (preferred)
• pip - Standard package installer
• poetry - Dependency management

Project Detection

Look for these files to identify Python projects:

• pyproject.toml - Modern project config
• setup.py - Legacy setup
• requirements.txt - Dependencies
• poetry.lock - Poetry lockfile
• uv.lock - UV lockfile

Common Workflows

Install Dependencies

Copy# With uv (fastest)
uv pip install -r requirements.txt 2>&1

# With poetry
poetry install 2>&1

# With pip
pip install -r requirements.txt 2>&1

Run Tests

Copypytest 2>&1
# or with verbose
pytest -v 2>&1

Lint

Copyruff check . 2>&1

Format

Copyruff format . 2>&1
# or
black . 2>&1

Type Check

Copymypy . 2>&1

Import Sorting

Copyisort . --check 2>&1

Poetry Projects

Copypoetry install          # Install deps
poetry run pytest       # Run tests
poetry run python main.py  # Run script

Virtual Environments

Copy# Create venv
python3 -m venv .venv
source .venv/bin/activate

# Or with uv
uv venv
source .venv/bin/activate

Best Practices

1. Use ruff for fast linting (replaces flake8, isort, etc.)
2. Use uv for fast package installation
3. Always run type checks with mypy
4. Check for pyproject.toml vs requirements.txt