holistic-linting
SKILL.md
Holistic Linting Skill
This skill embeds comprehensive linting and formatting verification into Claude Code's workflow, preventing the common pattern where code is claimed "production ready" without actually running quality checks.
Purpose
Prevent Claude from:
- Completing tasks without formatting and linting modified files
- Claiming code is "production quality" based on pattern-matching rather than verification
- Assuming only 2 linters exist (mypy + ruff) when projects may have 4+ linting tools
- Suppressing linting errors with
# type: ignoreor# noqacomments without understanding root causes
Ensure Claude:
- Automatically formats and lints all modified files before task completion
- Reads project-specific linting configuration from
CLAUDE.md - Resolves linting issues systematically using root-cause analysis
- Orchestrates concurrent linting agents when multiple files have issues