ruff-review

Run Ruff lint reports on folders or files and triage issues interactively.

2|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/cameronmaske/agent-stuff --skill ruff-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ruff-review
Source: https://github.com/cameronmaske/agent-stuff/tree/main/skills/ruff-review
Command: npx skills add https://github.com/cameronmaske/agent-stuff --skill ruff-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ruff, and includes scripts (resource) components.

What problem does it solve?

Ruff linting across large codebases can be tedious to triage. This Skill runs Ruff and presents an organized, interactive flow to decide which issues to fix or ignore.

Core Features & Use Cases

  • Run Ruff on a folder or file to generate a structured list of issues.
  • Interactively review each issue and choose to fix or ignore it.
  • Optionally save raw Ruff output to JSON for later reference and auditing.

Quick Start

Run a lint report on a project folder and save issues: uv run {baseDir}/scripts/ruff_report.py <path> --save .ruff-issues.json

or

python {baseDir}/scripts/ruff_report.py <path> --save .ruff-issues.json

Frequently Asked Questions about ruff-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I triage Ruff lint issues across a large Python codebase?

You can triage Ruff lint issues by running a folder-wide report that generates a structured list, then interactively reviewing each issue to fix or ignore it. This simplifies managing Ruff lint output for large projects.

How do I interactively review and fix Python static analysis errors from Ruff?

To interactively review Python static analysis errors, run the Ruff report script on a file or directory. The guided flow prompts you to iteratively make fix-or-ignore decisions for each identified lint issue.

Do I need to install Ruff separately to run an interactive code review?

Yes, you must have Ruff installed on your PATH to run the interactive code review. The skill uses Ruff to apply configured lint rules and optionally reads project config from pyproject.toml or ruff.toml.

Can I save Ruff lint output to JSON for later auditing?

Yes, you can save the raw Ruff lint output to JSON. By running the report script with the save flag, you generate a JSON file for later reference and auditing of your codebase issues.

What is the best way to handle Ruff linting for a single Python file?

The best way to handle Ruff linting for a single file is to pass the file path to the report script. The skill supports both directory and single file inputs to generate an interactive review flow.

Why does my Ruff review not apply my custom lint rules?

Your Ruff review may not apply custom lint rules if the configuration is missing. Ensure a valid pyproject.toml or ruff.toml file exists in your project so Ruff can load and apply your specific lint rules.