python-quality-gate

Enforce Python code quality with Ruff, pyright, Vulture, and deptry.

6|1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/kmshihab7878/claude-code-setup --skill python-quality-gate-kmshihab7878
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-quality-gate
Source: https://github.com/kmshihab7878/claude-code-setup/tree/main/skills/python-quality-gate
Command: npx skills add https://github.com/kmshihab7878/claude-code-setup --skill python-quality-gate-kmshihab7878

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps Python 3.10+ codebases healthy by centralizing linting, formatting, type checking, dead-code detection, and dependency hygiene so teams can catch regressions early and maintain release quality.

Core Features & Use Cases

  • Multi-tool Quality Gate: Orchestrates Ruff for linting and formatting, pyright for types, Vulture for dead code detection, and deptry for dependency hygiene.
  • CI and Local Checks: Designed to run locally via just/Make targets or in CI pipelines and integrates with pre-commit for automated enforcement.
  • Measurable Targets: Defines quality targets such as zero lint errors, >80% public API type coverage, minimal dead-code findings, and no unused dependencies to drive continuous improvement.
  • Use Case: Run a full repository quality check before merging a major feature to ensure formatting, types, and dependency health meet team standards.

Quick Start

Run a full Python quality gate across the repository with Ruff, pyright, Vulture, and deptry using the project's quality check target.

Frequently Asked Questions about python-quality-gate

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

FAQPage Schema
How do I run a full Python code quality check before merging a feature?

To enforce Python code quality and dependency hygiene, this Skill orchestrates Ruff for linting, pyright for static type checking, Vulture for dead code discovery, and deptry for dependency auditing across a repository.

Does this Python quality gate work with pre-commit hooks and CI pipelines?

Yes, this Python quality gate integrates with pre-commit for automated enforcement and runs in CI pipelines or locally via just/Make targets to catch regressions early and maintain release quality.

How do I check for unused dependencies and dead code in a Python repository?

Check for unused dependencies and dead code using deptry for dependency hygiene and Vulture for dead code discovery. These tools identify unused dependencies and minimal dead-code findings across your Python 3.10+ project.

What's the best way to enforce type checking and formatting standards in Python?

The best way to enforce type checking and formatting is centralizing Ruff for formatting and pyright for static type checking. This approach defines measurable targets like over 80% public API type coverage and zero lint errors.

Do I need specific tool binaries available to run multi-tool Python linting?

Yes, you need the respective tool binaries for Ruff, pyright, Vulture, and deptry available in your environment to execute the multi-tool Python linting, formatting, and dependency auditing workflows.

Can I use this quality gate for Python 3.10 projects and newer?

Yes, this quality gate applies to Python 3.10 and newer projects, enforcing formatting, types, and dependency health standards across your repository in both local and CI workflows.