quality

Code Quality Skill

Code quality validation, formatting, linting, and pre-commit checks.

Activation

Auto-activates on keywords: quality, lint, format, precommit, naming, black, ruff, mypy, basedpyright, validation

Workflows

Formatting

• format.md: Code formatting with Black and Ruff

Linting

• lint.md: Linting checks with Ruff
• naming.md: Naming convention validation

Pre-commit

• precommit.md: Pre-commit hook validation

Commands

# Format code
uv run black .
uv run ruff format .

# Lint code
uv run ruff check .
uv run ruff check --fix .

# Type checking
uv run basedpyright src/

# Run all pre-commit hooks
uv run pre-commit run --all-files

Quality Standards

Python Standards

• Line Length: 88 characters (Black default)
• Type Checking: BasedPyright strict mode
• Linting: Ruff with PyStrict-aligned rules

Rule Categories

• BLE: Blind except detection
• EM: Error message best practices
• SLF: Private member access violations
• INP: Require __init__.py in packages
• T10: No debugger statements
• G: Logging format strings

Per-File Ignores

Tests and scripts have relaxed rules for pragmatic development.