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.