python-linting

Identify and fix Python linting and type-checking issues with Ruff and Pyright.

Updated Sep 8, 2025
One-click install
npx skills add https://github.com/randalmurphal/claude-config --skill python-linting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-linting
Source: https://github.com/randalmurphal/claude-config/tree/main/skills/python-linting
Command: npx skills add https://github.com/randalmurphal/claude-config --skill python-linting

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ruff, pyright.

What problem does it solve?

This Skill streamlines Python code quality by leveraging modern tools like Ruff (for linting and formatting) and Pyright (for type checking). It helps developers quickly identify and fix style issues, simple bugs, and critical type errors, ensuring consistent, high-quality, and maintainable Python code.

Core Features & Use Cases

  • Comprehensive Code Quality: Covers style, formatting, simple bugs (Ruff) and type safety, attribute errors, None-safety (Pyright).
  • Blazing Fast Execution: Replaces multiple slower tools (Pylint, Black, Mypy) with a combined 20-40x speed improvement.
  • Configuration & Troubleshooting: Provides guidance on ruff.toml and pyrightconfig.json setup, common error patterns, and suppression techniques.
  • Use Case: Automatically analyze a Python codebase for linting and type errors, generate a report of violations, and suggest auto-fix commands using Ruff to quickly resolve issues.

Quick Start

Use the python-linting skill to check the current Python project for linting and type errors, then suggest commands to auto-fix them.

Frequently Asked Questions about python-linting

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

FAQPage Schema
How do I check a Python project for linting and type errors?

Use Ruff and Pyright to check your Python project for linting and type errors. Ruff identifies style issues and simple bugs; Pyright detects type mismatches, attribute errors, and None-safety problems. Run both tools locally or in CI to catch issues before deployment.

What's the difference between Ruff and Pyright for Python code quality?

Ruff handles linting, formatting, and simple bug detection with blazing speed, replacing Pylint and Black. Pyright performs type checking, catching attribute errors and None-safety issues. Together they provide comprehensive code quality coverage 20-40x faster than traditional tools.

How do I configure Ruff and Pyright for my Python project?

Configure Ruff using ruff.toml or pyproject.toml with your preferred rules and formatting options. Configure Pyright with pyrightconfig.json to set type-checking strictness and ignored paths. Both support standard configurations for local development and CI workflows.

Can I automatically fix Python linting issues with Ruff?

Yes, Ruff includes auto-fix capabilities for many linting rules. Run Ruff with the fix flag to automatically resolve style issues and formatting problems, then commit the changes or review them in CI before merging.

When should I use noqa comments to suppress linting errors?

Use noqa comments to suppress specific linting or type-checking violations when they are intentional or unavoidable. Apply them narrowly to individual lines or specific rule codes rather than disabling checks globally, keeping code quality oversight intact.

Why is type checking important for Python development?

Type checking with Pyright catches attribute errors, None-safety issues, and type mismatches early, reducing runtime bugs and improving code maintainability. Combined with Ruff's linting, it ensures consistent, high-quality Python code across your project.