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.

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

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.
nameadd-check
descriptionAdd 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.toml if needed
  • Add justfile recipe and update default target
  • Add CI workflow step
  • Add lefthook pre-commit job
  • Run just to verify all checks pass