ruff-dev

Ruff Professional Development

Version: 0.14.10 (Documentation generated December 2025)

Overview

Ruff is an extremely fast Python linter and formatter written in Rust. It combines the functionality of multiple Python tools (Flake8, isort, Black, pyupgrade, and more) into a single high-performance tool.

This skill provides comprehensive guidance for:

• Configuring and integrating Ruff into Python projects
• Understanding and fixing lint rule violations
• Formatting Python code with Ruff's formatter
• Setting up editor integrations
• Migrating from other Python tooling

Quick Start

Installation

See references/installation.md for complete installation instructions across all platforms and package managers.

Basic Usage

Linting:

ruff check .                    # Lint all files
ruff check path/to/file.py      # Lint specific file
ruff check --fix .              # Auto-fix violations

Formatting:

ruff format .                   # Format all files
ruff format path/to/file.py     # Format specific file
ruff format --check .           # Check formatting without changes

Configuration:

# pyproject.toml or ruff.toml
[tool.ruff]
line-length = 88
target-version = "py311"

[tool.ruff.lint]
select = ["E", "F", "I"]
ignore = ["E501"]

See references/configuration.md for comprehensive configuration options.

Core Workflows

1. Integrating Ruff into a Project

Steps:

1. Install Ruff (see references/installation.md)
2. Create initial configuration (see references/configuration.md)
3. Run initial check: ruff check .
4. Review and configure rules (see references/settings.md)
5. Set up pre-commit hooks or CI integration (see references/integrations.md)

2. Fixing Lint Violations

Process:

1. Run ruff check . to identify violations
2. For specific rule violations, reference references/rules/<rule-name>.md
3. Apply automatic fixes: ruff check --fix .
4. Manual fixes for remaining violations using rule documentation