mcpField
P
python-code-quality

python-code-quality

github.com/laurigatesTesting & quality591.0k installsUpdated 1d ago
Repository

About python-code-quality

An orchestration index for Python project quality tools, intended for developers planning linting, formatting, type checking, and tests together. It routes tool-specific details to focused skills and describes coordination in pre-commit and CI.

Key features

  1. 01Maps the Python quality tool stack
  2. 02Routes tasks to focused skills
  3. 03Describes tool coordination in pre-commit
  4. 04Outlines CI quality-check steps

Use cases

  1. 01Setting up a quality stack for a new project
  2. 02Planning linting, formatting, and type checking
  3. 03Integrating quality tools with pre-commit and CI

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/laurigates/claude-plugins --skill python-code-quality

After installing, type/python-code-qualityin Claude Code to confirm it loaded.

Details

From the project README

Python Code Quality

Orchestration index for the Python quality stack. This skill routes to the focused skills that own each tool — it does not restate their commands. Reach for it when setting up or reasoning about the whole stack (lint + format + type-check + tests) at once; reach for a focused skill when tuning one tool.

When to Use This Skill

Use this skill when...Use a focused sibling instead when...
Standing up a complete quality stack for a new projectTuning only ruff lint rule selection — use ruff-linting
Reasoning about how the tools fit together / comparing themConfiguring only ruff formatter quirks — use ruff-formatting
Wiring lint + type-check into pre-commit and CI togetherConfiguring strict type-checker rules — use ty-type-checking or basedpyright-type-checking

Routing Table

ConcernFocused skill
Lint rules, rule selection, auto-fixpython-plugin:ruff-linting
Code formatting (quote style, line length)python-plugin:ruff-formatting
Editor / pre-commit / CI / Docker wiring for ruffpython-plugin:ruff-linting → its REFERENCE.md
Type checking with typython-plugin:ty-type-checking
Type checking with basedpyrightpython-plugin:basedpyright-type-checking
Dead-code detectionpython-plugin:vulture-dead-code
Test quality / coveragepython-plugin:python-testing, python-plugin:pytest-advanced
Modern type-hint syntax and idiomspython-plugin:python-development
Adding the tools to a projectpython-plugin:uv-project-management

Full Stack at a Glance

The one thing this index owns: the tools running together in pre-commit. For each tool's flags and config, follow the routing table above.

# .pre-commit-config.yaml — ruff (lint + format) and ty together
repos:
  - repo: https://github.com/astral-sh/ruff-pre-commit
    rev: v0.14.0
    hooks:
      - id: ruff-check
        args: [--fix]
      - id: ruff-format
  - repo: https://github.com/astral-sh/ty
    rev: v0.0.10
    hooks:
      - id: ty

A typical CI quality gate runs the same three steps: ruff check, ruff format --check, ty check. See ruff-linting § CI/CD Integration and ty-type-checking for the runnable forms.

References

Comments

Markdown supported