quality

Automate Python code quality validation, formatting, linting, and pre-commit checks.

Updated Jul 2, 2025
One-click install
npx skills add https://github.com/williaby/.claude --skill quality
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: quality
Source: https://github.com/williaby/.claude/tree/main/skills/quality
Command: npx skills add https://github.com/williaby/.claude --skill quality

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires poetry, black, ruff, mypy, markdownlint, yamllint.

What problem does it solve?

This Skill centralizes and automates all aspects of code quality, from formatting and linting to pre-commit validation. It eliminates manual, error-prone checks and ensures consistent code standards across projects, saving developers time and reducing the cognitive load of maintaining high-quality code.

Core Features & Use Cases

  • Automated Formatting: Instantly format code (Python, Markdown, YAML) to project standards.
  • Intelligent Linting: Automatically detect and fix linting issues with tools like Ruff.
  • Pre-commit Validation: Run a comprehensive suite of checks (formatting, linting, type checking, security, tests) before every commit.
  • Use Case: Before committing, simply run /quality/precommit to automatically format, lint, type-check, and run tests on your changes, ensuring your code meets all project standards without manual effort.

Quick Start

Run a full pre-commit validation, including formatting, linting, and tests, on your current changes. /quality/precommit

Frequently Asked Questions about quality

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

FAQPage Schema
How do I automate code formatting and linting for Python projects?▼

Automate code formatting and linting by running pre-commit validation, which applies Black formatting at 88-character line length, Ruff auto-fixable linting, and MyPy type checking. This ensures consistent standards across your codebase without manual checks.

Can I run code quality checks before every commit?▼

Yes. Run `/quality/precommit` to automatically format, lint, type-check, and validate tests on your changes before committing. The optional `--fix` flag auto-corrects issues, ensuring code meets project standards.

What tools does this use for Python code quality?▼

This Skill integrates Black for formatting, Ruff for linting with auto-fixes, MyPy for type checking, and markdownlint and yamllint for documentation and configuration files, plus pre-commit validation.

How do I enforce minimum test coverage standards?▼

The pre-commit validation enforces a minimum 80% test coverage requirement as part of comprehensive checks, combined with formatting, linting, and type checking to catch issues before they reach your repository.

Does this work with existing CI pipelines?▼

Yes. The Skill routes quality tasks to dedicated workflows integrated with standard tools and references, making it compatible with CI pipelines alongside Poetry dependency management and other automation tools.