uv-ruff-python-tools_skill

Overview

This skill integrates uv (a high-performance Python package manager) and ruff (a fast linter/formatter) to streamline modern Python development. It helps set up projects, manage dependencies and Python versions, and enforce fast, consistent code quality checks. Use it to speed installs, maintain reproducible environments, and apply rules-driven linting and formatting across codebases.

How this skill works

The skill runs uv commands to initialize projects, add or sync dependencies, manage Python versions, and run tools inside isolated project environments. It runs ruff to lint, auto-fix, and format code, with support for watch mode, JSON/GitHub outputs, and per-file rule configuration via pyproject.toml. Combined workflows use uv to install ruff and execute checks inside the project environment for reproducible CI and local runs.

When to use it

• Creating or initializing new Python projects with modern tooling
• Installing, updating, or syncing dependencies much faster than pip
• Managing multiple Python versions and pinning per-project interpreters
• Linting, auto-fixing, and formatting Python code at scale
• Adding fast pre-commit hooks or CI lint/format checks
• Migrating from pip/conda/poetry/pipx to a unified workflow

Best practices

• Pin project Python versions in pyproject.toml for reproducible builds
• Keep uv.lock committed to ensure identical dependency resolution across platforms
• Install ruff via uv and run checks through uv run to use project-local tools
• Enable ruff fix and format in pre-commit hooks for consistent style on commit
• Use uvx to run ephemeral tools (like ruff, black, pytest) without global installs
• Leverage ruff’s output formats (json/github) for CI reporting

Example use cases

• Bootstrapping a new library: uv init, uv add dependencies, uv python pin, uv sync
• CI pipeline: install uv, uv sync, uv run ruff check ., uv run ruff format --check
• Developer machine setup: uv python install multiple versions and create a project venv automatically
• Codebase cleanup: ruff check --fix . && ruff format . to remove unused imports and normalize formatting
• Pre-commit enforcement: run ruff --fix and ruff-format as hooks to avoid style drift