Why does the skill forbid using suppression comments like # noqa?

To maintain high code quality standards. The skill is designed to find and fix the root cause of an error rather than simply hiding the symptom, preventing technical debt.

How does it ensure the fix doesn't break other files?

The workflow includes a verification step that reruns the linter on the primary file and every incidentally modified file, requiring a zero-error count for completion.

What linters does this skill support?

It provides specialized workflows for Ruff (style and code quality), Mypy (type checking), and Pyright/Basedpyright (strict type checking).

Can I use this skill to configure my pyproject.toml?

No, this skill specifically forbids modifying configuration files to reduce rule severity. It is focused strictly on code-level resolutions.

Is this for orchestrator or sub-agent use?

This is a sub-agent skill intended for executing specific linting resolution tasks. Orchestrators should use the holistic-linting-orchestrator for delegation.

Holistic Python Linting Resolver

Name: Holistic Python Linting Resolver
Author: Jamie-BitFlight

byJamie-BitFlight

•

Security & Testing

Resolves Python linting and type errors systematically using specialized workflows for Ruff, Mypy, and Pyright.

The Holistic Linting Resolver is a specialized sub-agent skill designed to fix Python code quality and typing issues without resorting to suppression comments or configuration downgrades. By providing structured workflows for popular tools like Ruff, Mypy, and Basedpyright, it guides Claude through root-cause analysis, architectural context checking, and rigorous verification. It ensures that every linting error is addressed with an elegant code fix following modern Python 3.11+ standards, maintaining high levels of type safety and maintainability across the entire codebase.

Key Features

01Mandatory suppression gate that prevents silencing errors via comments or config changes.

0220 GitHub stars

03Systematic resolution workflows for Ruff, Mypy, and Pyright/Basedpyright.

04Automatic Ruff rule documentation lookup to implement principle-based fixes.

05Integrated verification protocol ensuring zero errors in all modified files.

06Deep type flow analysis for tracing complex Mypy and Pyright type mismatches.

Use Cases

01Resolving complex type-checking errors in large-scale Python applications.

02Modernizing legacy Python code by fixing Ruff style and quality violations.

03Systematic cleanup of type narrowing and Optional member access issues.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jamie-bitflight/claude_skills holistic-linting-resolver

For use in Claude.ai and ChatGPT

Download Skill