add-check
Add a new code quality check to CI, justfile, and pre-commit hooks. Use when adding linters, formatters, type checkers, or other code quality tools to the project.
When & Why to Use This Skill
This Claude skill automates the integration of code quality tools into your development workflow. It streamlines the process of adding linters, formatters, and type checkers across three critical layers: GitHub Actions CI pipelines, local task runners (justfile), and pre-commit hooks (lefthook). By ensuring consistency between local development and remote verification, it helps maintain high code standards and prevents integration regressions.
Use Cases
- Integrating a new linter like Ruff or ESLint to enforce coding standards across the team.
- Adding static type checkers such as Mypy or Pyright to the CI pipeline to catch type-related bugs early.
- Configuring automated code formatters (e.g., Black, Prettier) to run via pre-commit hooks, ensuring only formatted code is committed.
- Standardizing local development commands by updating the project's justfile to include new validation steps.
| name | add-check |
|---|---|
| description | Add a new code quality check to CI, justfile, and pre-commit hooks. Use when adding linters, formatters, type checkers, or other code quality tools to the project. |
Adding a New Check
When adding a new code quality check (linter, formatter, type checker, etc.), update these three locations:
1. justfile
Add a new recipe and include it in the default target:
default: lint format typecheck your-check
your-check:
uv run YOUR_COMMAND
2. .github/workflows/ci.yaml
Add a step to the verify job after the existing checks:
- name: Run YOUR_CHECK
run: uv run YOUR_COMMAND
3. lefthook.yml
Add a job to the pre-commit.jobs list:
- name: YOUR_CHECK
glob: "*.py"
run: YOUR_COMMAND {staged_files}
If the tool can auto-fix issues, add stage_fixed: true.
Checklist
- Add dev dependency to
pyproject.tomlif needed - Add justfile recipe and update
defaulttarget - Add CI workflow step
- Add lefthook pre-commit job
- Run
justto verify all checks pass