🛠️ 開発・MCP コミュニティ

lefthook

Git hooks管理ツールLefthookの設定ファイル作成やデバッグ、エラー解決を支援し、pre-commitやpre-pushなどのフック実行、ファイルフィルタリング、ジョブ定義など、Lefthookに関するあらゆる疑問に対応するSkill。

📜 元の英語説明(参考)

Write, debug, and explain Lefthook configuration for Git hooks. Use this skill when the user mentions `lefthook`, `lefthook.yml`, `lefthook install`, `pre-commit`, `pre-push`, staged-file or push-file filtering, `jobs`, `commands`, `scripts`, local overrides, or troubleshooting hook execution and recursive hook behavior.

🇯🇵 日本人クリエイター向け解説

一言でいうと

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux

mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o lefthook.zip https://jpskill.com/download/8680.zip && unzip -o lefthook.zip && rm lefthook.zip

🪟 Windows (PowerShell)

$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/8680.zip -OutFile "$d\lefthook.zip"; Expand-Archive "$d\lefthook.zip" -DestinationPath $d -Force; ri "$d\lefthook.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)

1. 下の青いボタンを押して lefthook.zip をダウンロード
2. ZIPファイルをダブルクリックで解凍 → lefthook フォルダができる
3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
4. Claude Code を再起動

⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
- · macOS / Linux: ~/.claude/skills/
- · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →

最終更新: 2026-05-18
取得日時: 2026-05-18
同梱ファイル: 1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Lefthook

このスキルを使用すると、Lefthook を使用して高速で保守可能な Git フックを構成できます。

はじめに

インストール手順をプロジェクトのエコシステム（npm、Go、Ruby、Python、Homebrew、またはスタンドアロンバイナリ）に合わせてください。
新しい構成には jobs を優先してください。commands と scripts も依然として有効であり、一般的です。
{staged_files}、{push_files}、glob、file_types、および root を使用して、フックを高速にし、ファイルスコープに保ちます。
構文チェックには lefthook validate を実行し、マージされた構成をデバッグするときは lefthook dump を実行します。
覚えておいてください: lefthook install は通常、一度限りのセットアップです。構成の変更は、各フックの実行時に読み込まれます。

高速ルーティング

ニーズ	参照
インストールと公式ドキュメントマップ	`references/official-docs.md`
CLI、構成モデル、テンプレート、マージ順序	`references/api-surface.md`
一般的な実際のパターン	`references/common-use-cases.md`
フックがスキップされたり、奇妙な動作をする理由	`references/troubleshooting-workarounds.md`
コピー可能な構成	`examples/basic-lefthook.yml`、`examples/monorepo-jobs.yml`、`examples/commit-message.yml`、`examples/lefthook-local.yml`
悪いパターンと修正	`examples/anti-patterns.md`

推奨ワークフロー

既存のパッケージスクリプト、リンター、テストコマンド、および現在の Git フックツールを調べます。
最小限の有用なフックの範囲を選択します。通常は pre-commit、commit-msg、および pre-push です。
グルーピング、名前付きマージ、または外部実行可能ファイルが必要かどうかに基づいて、jobs、commands、または scripts を選択します。
チェックがリポジトリ全体を本当に必要としない限り、作業を変更されたファイルに限定します。
ローカルオーバーライドまたは共有ポリシーが必要な場合にのみ、lefthook-local.yml、extends、または remotes を追加します。

コア規則

ワークフローが明示的にプロンプトを必要としない限り、決定論的で非対話型のフックを優先します。
stage_fixed: true は、ステージングされたファイルを変更する pre-commit フィクサーにのみ使用します。
root が作業ディレクトリを変更した場合でも、glob は Git リポジトリのルートから評価されることを覚えておいてください。
Git フックに再帰的に戻るツールには LEFTHOOK=0 を使用します。
完全な Git フローをテストする前に、lefthook run <hook> を使用してフックを直接デバッグします。

外部ドキュメント

ドキュメント: https://lefthook.dev/
GitHub: https://github.com/evilmartians/lefthook

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Lefthook

Use this skill to configure fast, maintainable Git hooks with Lefthook.

Start Here

Match install instructions to the project ecosystem: npm, Go, Ruby, Python, Homebrew, or standalone binary.
Prefer jobs for new configs; commands and scripts are still valid and common.
Keep hooks fast and file-scoped with {staged_files}, {push_files}, glob, file_types, and root.
Run lefthook validate for syntax checks and lefthook dump when debugging merged config.
Remember: lefthook install is usually one-time setup; config changes are read on each hook execution.

Fast Routing

Need	Read
Install and official docs map	`references/official-docs.md`
CLI, config model, templates, merge order	`references/api-surface.md`
Common real-world patterns	`references/common-use-cases.md`
Why a hook is skipped or behaving oddly	`references/troubleshooting-workarounds.md`
Ready-to-copy configs	`examples/basic-lefthook.yml`, `examples/monorepo-jobs.yml`, `examples/commit-message.yml`, `examples/lefthook-local.yml`
Bad patterns and fixes	`examples/anti-patterns.md`

Recommended Workflow

Inspect existing package scripts, linters, test commands, and current Git hook tooling.
Choose the smallest useful hook surface: usually pre-commit, commit-msg, and pre-push.
Pick jobs, commands, or scripts based on whether you need grouping, named merges, or external executables.
Scope work to changed files unless the check truly needs the whole repository.
Add lefthook-local.yml, extends, or remotes only when you need local overrides or shared policy.

Core Rules

Prefer deterministic, non-interactive hooks unless the workflow explicitly requires prompts.
Use stage_fixed: true only for pre-commit fixers that modify staged files.
Remember that glob is evaluated from the Git repo root, even when root changes the working directory.
Use LEFTHOOK=0 for tools that would otherwise recurse back into Git hooks.
Use lefthook run <hook> to debug a hook directly before testing the full Git flow.

External Docs

Docs: https://lefthook.dev/
GitHub: https://github.com/evilmartians/lefthook