Skill Detail

Ruff Python Linter Configurator

Generates optimized Ruff configuration from existing Flake8, isort, and Black setups. Migrates pyproject.toml rules with automatic conflict resolution.

Code Quality & ReviewCustom Agents
Code Quality & Review Custom Agents Security Reviewed
โญ 47.2k GitHub stars
INSTALL WITH ANY AGENT
npx skills add agentskillexchange/skills --skill ruff-python-linter-configurator Copy
Works best when you want a reusable capability, not another fragile one-off prompt.
At a glance
Install & setup
pip install ruff
Author
Astral
Last updated
Mar 24, 2026
Quick brief

The Ruff Python Linter Configurator skill automates migration from legacy Python linting toolchains (Flake8, isort, Black, pylint, pycodestyle) to the Ruff linter by analyzing existing configuration files and generating equivalent ruff.toml or pyproject.toml [tool.ruff] sections.

How it works

What this skill actually does

The configurator parses .flake8, setup.cfg, tox.ini, and pyproject.toml to extract all active rules, per-file-ignores, max-line-length settings, and import sorting preferences. It maps Flake8 plugin codes to Ruff rule prefixes (E/W for pycodestyle, F for pyflakes, I for isort, UP for pyupgrade, B for flake8-bugbear) with automatic conflict resolution when rules contradict.

The output configuration includes select and ignore lists, fixable rules for auto-formatting, target Python version inference from pyproject.toml requires-python, and per-file overrides for test directories and scripts. Performance benchmarking compares Ruff execution time against the replaced tools to quantify the speedup. A migration checklist identifies rules that have no Ruff equivalent and suggests alternatives.