| name | ruff-check |
| description | Lints and formats all Python files in the project using Ruff. Activates when the user asks to "lint my Python", "fix Python code style", "run ruff", "format my Python files", "check Python quality", or "fix linting errors". Installs Ruff if not present, auto-fixes resolvable issues, and reports remaining violations.
|
Python Linting and Formatting with Ruff
Lint and auto-format all Python files in the project using Ruff — the fast,
all-in-one Python linter and formatter that replaces flake8, isort, and black.
Workflow
Step 1 — Install Ruff (if not present)
uv add --dev ruff 2>/dev/null || \
pip install ruff
Step 2 — Check for violations
ruff check .
Report the number of violations found and their categories.
Step 3 — Auto-fix resolvable violations
ruff check --fix .
Step 4 — Format code (replaces black)
ruff format .
Step 5 — Final verification
ruff check . && ruff format --check .
Report outcome:
✓ No violations — all files clean.- List any remaining violations that require manual attention.
Useful Options
| Flag | Purpose |
|---|
ruff check --select E,W | Errors and warnings only |
ruff check --fix --unsafe-fixes | Apply unsafe fixes as well |
ruff format --diff | Preview formatting changes without applying |
ruff check --statistics | Show count per rule |
On Remaining Violations
For each violation that could not be auto-fixed:
- Show the file path and line number
- Explain what the rule requires
- Suggest the manual fix
