lefthook

Lefthook リファレンス

Lefthook（lefthook.dev）の全ドキュメントを網羅したスキル。 ユーザーのタスクに応じて適切な README.md を読み、そこから個別ファイルへ辿ること。

対象 Lefthook v2.2.2（2026-10 時点、GitHub タグ v2.2.2 の docs/ が原本）。

ディレクトリ構成

skills/lefthook/
  SKILL.md
  references/
    installation/
      README.md
      overview.md
      node.md
      ruby.md
      go.md
      python.md
      php.md
      swift.md
      homebrew.md
      winget.md
      scoop.md
      deb.md
      rpm.md
      alpine.md
      arch.md
      snap.md
      devbox.md
      mise.md
      manual.md
    configuration/
      README.md
      ai.md
      global-settings.md
      hook-settings.md
      command-settings.md
      script-settings.md
      source-dir.md
      remotes.md
    usage/
      README.md
      commands.md
      environment-variables.md
    examples/
      README.md
      commitlint.md
      filters.md
      lefthook-local.md
      protect-branch.md
      remotes.md
      skip.md
      stage-fixed.md
      wrap-commands.md
  samples/
    README.md
    basic-setup.md
    parallel-execution.md
    auto-fix-and-stage.md
    commitlint-integration.md
    local-override.md
    conditional-skip.md
    monorepo-setup.md
    shared-config-via-remotes.md
  scripts/
    README.md
    cli.md
    install.md
    run-with-env.md

探索手順

タスクからカテゴリを引き、カテゴリの README.md で目的のページを特定する:

1. 下記マッピング表でタスクに対応するカテゴリを探す
2. そのカテゴリの references/{category}/README.md を参照して目的のページを特定する
3. 該当ページの .md を Read して詳細を確認する

タスク → カテゴリ マッピング

タスク	カテゴリ	参照 README
Lefthook のインストール・セットアップ	installation	references/installation/README.md
npm / yarn / pnpm / pip / gem / composer でのインストール	installation	references/installation/README.md
Homebrew / Scoop / Winget / APK / AUR でのインストール	installation	references/installation/README.md
バイナリ手動インストール・mise / devbox 対応	installation	references/installation/README.md
lefthook.yml のグローバル設定	configuration	references/configuration/README.md
Hook 設定（parallel, piped, follow, skip）	configuration	references/configuration/README.md
Command 設定（run, glob, files, stage_fixed）	configuration	references/configuration/README.md
Script 設定・source_dir の変更	configuration	references/configuration/README.md
remotes による設定共有	configuration	references/configuration/README.md
AI エージェント hooks（ai: claude / codex / cursor / copilot の hooks 設定ファイル生成）	configuration	references/configuration/README.md
エディタ補完・JSON schema（lefthook.dev/schema.json）	configuration	references/configuration/README.md
lefthook install / run / add / validate / dump	usage	references/usage/README.md
環境変数（LEFTHOOK, LEFTHOOK_VERBOSE 等）による制御	usage	references/usage/README.md
commitlint / Commitizen 統合	examples	references/examples/README.md
ファイルフィルタリング（glob / staged_files / tags）	examples	references/examples/README.md
lefthook-local.yml でのローカルオーバーライド	examples	references/examples/README.md
条件付きスキップ・ブランチ制限	examples	references/examples/README.md
現在のブランチが main / master のときの push を pre-push でブロック（push 先 ref は判定しない）	examples	references/examples/README.md
典型的な使い方を知りたい	samples	samples/README.md
インストール・CLI コマンドを知りたい	scripts	scripts/README.md