When to reach for the Ruff skill

Updated Aug 23, 2026

ruff-016 covers Ruff as a tool rather than any one rule family.

  • Upgrading. Ruff 0.16.0 raised the default rule set from 59 to 413, started formatting Python blocks in Markdown files, and made fields in the JSON output nullable. An upgrade needs a plan, not a version bump.
  • Configuration review. Whether select, ignore, and per-file-ignores still say what the project means under the new defaults, and which of the settings added since 0.14.0 apply.
  • Suppression. ruff: ignore, ruff: file-ignore, and ruff: disable/enable versus noqa, plus --add-ignore and the RUF100RUF106 hygiene rules.
  • "Does this rule exist yet?" The reference tables record what stabilized in 0.15.0 and 0.16.0 and what remains in preview, material that postdates most models' training data.

Rule-level questions about exceptions and logging stay with python-errors-and-logging; its ruff-rule-map.md reference is the decision surface for TRY, BLE, EM, LOG, N818, and PERF203.