Agent skill
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.
Install this agent skill to your Project
npx add-skill https://github.com/williaby/.claude/tree/main/skills/quality
SKILL.md
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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
testing
Automated test generation, review, and execution for pytest-based projects. Auto-activates on keywords test, coverage, pytest, unittest, integration test, e2e, performance, benchmark, security testing. Routes to specialized testing workflows based on user intent.
rad
Response-Aware Development (RAD) - Systematic verification of code assumptions using multi-model AI analysis. Auto-activates on keywords assumption, verify assumptions, list assumptions, RAD, response-aware, assumption tags, critical assumptions, assumption verification. Routes to verification, listing, and testing workflows.
security
Security validation, vulnerability scanning, and compliance checking for development environments. Auto-activates on keywords security, vulnerability, audit, OWASP, encryption, GPG, SSH, signing, secrets, scan. Routes to specialized security workflows.
git
Git workflow management including branch validation, commit conventions, PR preparation, and repository health checks. Auto-activates on keywords git, branch, commit, pull request, PR, merge, rebase, workflow, conventional commits, branch strategy.
obsidian-vault
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
edit-article
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
Didn't find tool you were looking for?