quality

Code quality validation, formatting, linting, and pre-commit checks. Auto-activates on keywords quality, lint, format, precommit, naming, black, ruff, mypy, validation. Routes to specialized quality workflows.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

The Quality Skill is a comprehensive code validation and automation tool designed to maintain high standards in software development. It streamlines the development lifecycle by integrating industry-standard tools like Black, Ruff, and MyPy for automated formatting, linting, and type checking. By providing intelligent routing for pre-commit checks and naming convention audits, it helps developers eliminate technical debt, ensure PEP 8 compliance, and maintain a clean, professional codebase with minimal manual effort.

Use Cases

  • Automated Code Formatting: Instantly apply Black formatting to Python files to ensure consistent 88-character line lengths and standardized styling.
  • Static Analysis and Linting: Utilize Ruff to detect and auto-fix code smells, syntax errors, and stylistic inconsistencies before they reach production.
  • Type Safety Enforcement: Run MyPy type checks across source directories to identify potential runtime errors and improve code documentation through types.
  • Pre-commit Validation: Execute a unified suite of quality checks (formatting, linting, and testing) to ensure code is 'commit-ready' and passes CI/CD requirements.
  • Naming Convention Audits: Automatically verify that variable, function, and class names adhere to PEP 8 or project-specific standards to improve code readability.
namequality
descriptionCode quality validation, formatting, linting, and pre-commit checks. Auto-activates on keywords quality, lint, format, precommit, naming, black, ruff, mypy, validation. Routes to specialized quality workflows.
allowed-toolsRead, Bash(poetry:*, black:*, ruff:*, mypy:*, markdownlint:*, yamllint:*), Grep, Task

Quality Skill

Comprehensive code quality domain for formatting, linting, type checking, and pre-commit validation. Provides automated quality workflows with intelligent routing.

Auto-Activation Keywords

This skill activates automatically when you mention:

  • General: quality, code quality, validation, standards
  • Formatting: format, formatting, black, prettier
  • Linting: lint, linting, ruff, eslint
  • Type checking: type check, mypy, types
  • Pre-commit: precommit, pre-commit, validate
  • Naming: naming conventions, naming, PEP 8

Routing Logic

Based on user intent, routes to appropriate workflows:

Code Formatting

Keywords: "format code", "black", "apply formatting" → Use /quality/format workflow

Linting

Keywords: "lint code", "ruff", "check linting" → Use /quality/lint workflow

Pre-commit Validation

Keywords: "validate before commit", "precommit check", "ready to commit" → Use /quality/precommit workflow

Naming Conventions

Keywords: "check naming", "naming conventions", "PEP 8" → Use /quality/naming workflow

Workflow Quick Reference

# Format code
/quality/format [path]

# Lint code
/quality/lint [path]

# Pre-commit validation
/quality/precommit [--fix]

# Check naming conventions
/quality/naming [path]

Complex Task Delegation

For comprehensive code review, invoke the code-reviewer agent via Task tool.

Supporting Context

  • Linting standards: /standards/linting.md
  • Python standards: /standards/python.md

Integration Points

Agents

  • code-reviewer: Comprehensive code quality analysis

Hooks

  • TDD enforcement on Write/Edit operations

Standards

  • Python standards: /standards/python.md (Black 88 chars, Ruff, MyPy)
  • Linting standards: /standards/linting.md (configuration)

Quality Requirements Summary

Required for all Python projects:

  • Black formatting (88-character line length)
  • Ruff linting (passes with --fix applied)
  • MyPy type checking (passes for src/)
  • 80%+ test coverage
  • Pre-commit hooks pass

Standard tools:

# Format
poetry run black src tests

# Lint  
poetry run ruff check --fix src tests

# Type check
poetry run mypy src

# Full validation
poetry run pre-commit run --all-files

This skill consolidates 6 quality commands and 2 validation skills into a unified quality domain.