eval-hooks

# Hooks Evaluator Discover all Claude Code hooks across every settings file in scope, validate each one against the filesystem and hook semantics, then run an interactive session to confirm or improve them. The goal is not just to score; it is to leave every hook working, correctly scoped, and safe to run. ## When to Use - First time adding hooks (validate before committing) - A hook never fires, or fires on every tool call - The agent hangs noticeably before executing a tool - A PreToolUse hook is supposed to block but doesn't - After copying hooks from another project or machine - Periodic hygiene: "are all these hooks still doing something useful?" ## Key Concepts ### Event types | Event | When it fires | Can block? (exit 2) | |---|---|---| | `PreToolUse` | Before any tool call | Yes | | `PermissionRequest` | When a permission dialog appears | Yes | | `PostToolUse` | After tool completes successfully | No (shows stderr to Claude) | | `PostToolUseFailure` | After a tool fails | No | | `PostToolBatch` | After a full batch of parallel tool calls resolves | Yes (stops agentic loop) | | `UserPromptSubmit` | When user submits a prompt | Yes | | `UserPromptExpansion` | When a slash command expands | Yes | | `Stop` | When Claude finishes responding | Yes (continues the turn) | | `SubagentStop` | When a subagent finishes | Yes (continues the subagent) | | `TeammateIdle` | When an agent team teammate goes idle | Yes | | `TaskCreated` | When a task is being created | Yes | | `...