Ruff Recursive Fix

This one automates the tedious cycle of running Ruff checks, applying fixes, reviewing diffs, and dealing with what's left over. It handles safe fixes first, then unsafe ones if you allow it, formats after each pass, and loops until everything is clean or needs your decision. The workflow is deliberate about when to add noqa suppressions, only doing so when you've got a real conflict with framework conventions or required behavior. It supports scoping to specific folders, overriding rules per run, and works with whatever Ruff setup you have, whether that's uv, direct install, or python -m. Honest take: the structured approach to reviewing unsafe fixes and forcing a decision on ambiguities prevents the usual autopilot mistakes.

skills.sh installs: 1.5K
GitHub stars: 41K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add github/awesome-copilot --skill ruff-recursive-fix --agent claude-code

Installs into .claude/skills of the current project.

Files

Ruff Recursive Fix

Overview

Use this skill to enforce code quality with Ruff in a controlled, iterative workflow. It supports:

Optional scope limitation to a specific folder.
Default project settings from pyproject.toml.
Flexible Ruff invocation (uv, direct ruff, python -m ruff, or equivalent).
Optional per-run rule overrides (--select, --ignore, --extend-select, --extend-ignore).
Automatic safe then unsafe autofixes.
Diff review after each fix pass.
Recursive repetition until findings are resolved or require a decision.
Judicious use of inline # noqa only when suppression is justified.