List Configured Hooks

VerifiedSafe

Displays all hooks configured in the project by reading .claude/settings.json and .claude/settings.local.json. It organizes hooks by event type (e.g., PreToolUse, PostToolUse) and shows their source file, matcher, type, and command/prompt. Useful for quickly reviewing what automation triggers are set up.

Sby Skills Guide Bot
DevelopmentBeginner
1306/2/2026
Claude Code
#hooks#configuration#claude-code#list-hooks

Recommended for

Our review

Displays a list of hooks configured in a Claude Code project from settings files.

Strengths

  • Clear visualization of hooks by event and source
  • Detection of hooks in both settings.json and settings.local.json files
  • Structured output with numbering for easy reference

Limitations

  • Only works with Claude Code, not other platforms
  • Does not allow editing or deleting hooks (read-only)
  • Depends on the presence of standard configuration files
When to use it

Use this skill to quickly inspect the hook configuration of your Claude Code project.

When not to use it

Do not use it if you need to modify hooks; it is read-only.

Security analysis

Safe
Quality score95/100

This skill only reads from local configuration files (.claude/settings.json and .claude/settings.local.json) using the Read tool, with no execution, network access, or destructive operations. It presents a safe, read-only list of hooks.

No concerns found

Examples

List all hooks
フック一覧を表示してください
Show hooks in English
Show me the configured hooks

name: list-hooks description: プロジェクトに設定されたフックの一覧を表示する。「フック一覧」「フックを見せて」「設定済みフック」「hooks 確認」「フックリスト」「hook 一覧」「フックを確認」などで起動。 allowed-tools: [Read]

List Hooks

プロジェクトに設定されたフックの一覧を表示します。

実行手順

  1. 以下のファイルから hooks セクションを読み込む:
    • .claude/settings.json
    • .claude/settings.local.json(存在する場合)
  2. イベント別にフックを整形して表示

フックイベントの種類

| イベント | 説明 | matcher | |----------|------|---------| | PreToolUse | ツール実行前(ブロック可能) | 必須 | | PostToolUse | ツール実行後 | 必須 | | PostToolUseFailure | ツール実行失敗後 | 必須 | | UserPromptSubmit | プロンプト送信時 | 不要 | | Notification | 通知時 | 不要 | | Stop | レスポンス完了時 | 不要 | | SubagentStart | サブエージェント開始時 | 不要 | | SubagentStop | サブエージェント完了時 | 不要 | | PreCompact | Compact 操作前 | 不要 | | SessionStart | セッション開始時 | 不要 | | SessionEnd | セッション終了時 | 不要 | | PermissionRequest | 権限要求時 | 不要 |

出力フォーマット

## 設定済みフック

### ソース別

| ソース | 件数 |
|--------|------|
| settings.json | 3 |
| settings.local.json | 1 |

### PreToolUse

| # | マッチャー | タイプ | コマンド/プロンプト | ソース |
|---|-----------|--------|---------------------|--------|
| 1 | Write | command | prettier --write "$FILE" | settings.json |
| 2 | Bash | prompt | 危険なコマンドをチェック | settings.local.json |

### PostToolUse

| # | マッチャー | タイプ | コマンド/プロンプト | ソース |
|---|-----------|--------|---------------------|--------|
| 1 | Write | command | eslint --fix "$FILE" | settings.json |

### SessionStart

| # | タイプ | コマンド/プロンプト | ソース |
|---|--------|---------------------|--------|
| 1 | command | echo "Session started" | settings.json |

重要な注意事項

  • ✅ settings.json と settings.local.json の両方を確認
  • ✅ フックがない場合は「フックは設定されていません」と表示
  • ✅ 各フックに番号を付与(削除時の参照用)
  • ✅ ソースファイルを明示(どのファイルで定義されているか)
  • ❌ フックの編集は行わない(表示のみ)
Related skills