ruff

Configure, tune, and operate Ruff for Python linting and formatting.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/westonwrz/codex-skills-by-codex --skill ruff-westonwrz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ruff
Source: https://github.com/westonwrz/codex-skills-by-codex/tree/main/ruff
Command: npx skills add https://github.com/westonwrz/codex-skills-by-codex --skill ruff-westonwrz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and agents (resource) components.

What problem does it solve?

This Skill helps you build, tune, and operate Ruff for Python linting, formatting, and editor/CI integration, ensuring consistent and high-quality Python code.

Core Features & Use Cases

  • Configuration Management: Set up canonical Ruff configurations, manage rule families, and integrate with tools like Black and Flake8.
  • Autofixing & Safety: Apply safe autofixes and isolate unsafe changes for review.
  • Performance Tuning: Optimize Ruff for monorepo-scale projects with caching and file discovery tuning.
  • Use Case: You're migrating a large Python project from Flake8 and Black to Ruff. Use this Skill to establish a baseline Ruff configuration, select appropriate rule families, and integrate Ruff into your pre-commit hooks and CI pipeline.

Quick Start

Use the ruff skill to check the current directory for linting errors.

Frequently Asked Questions about ruff

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

FAQPage Schema
How do I migrate from Black and Flake8 to Ruff for Python linting and formatting?

Migrating from Black and Flake8 to Ruff involves establishing a baseline Ruff configuration, selecting appropriate rule families, and replacing legacy tool integrations. This Skill automates configuration generation and maps existing lint rules to Ruff equivalents.

What is the best way to configure Ruff for a large Python monorepo?

Configuring Ruff for a large Python monorepo requires tuning file discovery, enabling caching, and managing configuration inheritance. This Skill optimizes Ruff performance for monorepo-scale projects by adjusting these settings to ensure fast linting and formatting.

How do I integrate Ruff into pre-commit hooks and CI pipelines?

Integrating Ruff into pre-commit hooks and CI pipelines requires defining Ruff checks in your configuration files. This Skill sets up canonical Ruff configurations and integration patterns for local development, pre-commit, and CI environments.

Can I apply safe autofixes with Ruff without breaking my Python code?

You can apply safe autofixes with Ruff by isolating unsafe changes for separate review. This Skill enforces autofix safety by separating safe and unsafe fixes, ensuring automated code corrections do not introduce unexpected behavior.

Why does Ruff formatting conflict with my existing Python lint rules?

Ruff formatting conflicts may arise from overlapping rule families or misconfigured formatter behavior. This Skill helps debug lint and format behavior by analyzing Ruff's configuration inheritance and rule selection strategies to resolve conflicts.

How do I select appropriate Ruff rule families for my Python project?

Selecting Ruff rule families requires evaluating your project's coding standards and compatibility needs. This Skill guides rule selection strategies and configuration management to tune Ruff for your specific Python code quality requirements.