hook-creator

Hook Creator

Overview

Creates hook configurations that respond to Claude Code events automatically. Hooks enable automation like formatting on save, running tests after edits, or custom session initialization.

When to use: User wants to automate workflows, needs event-driven behavior, or requests hooks for their plugin.

References: Consult plugins/meta/claude-docs/skills/claude-docs/reference/plugins-reference.md for hook specifications and available events.

Hook Structure Requirements

Hooks are defined in hooks/hooks.json with:

1. Event type (SessionStart, PostToolUse, etc.)
2. Matcher (optional, for filtering which tool uses trigger hook)
3. Hook actions (command, validation, notification)
4. Proper use of ${CLAUDE_PLUGIN_ROOT} for plugin-relative paths

Available Events

From official documentation:

• PreToolUse - Before Claude uses any tool
• PostToolUse - After Claude uses any tool
• UserPromptSubmit - When user submits a prompt
• Notification - When Claude Code sends notifications
• Stop - When Claude attempts to stop
• SubagentStop - When subagent attempts to stop
• SessionStart - At session beginning
• SessionEnd - At session end
• PreCompact - Before conversation history compaction

Creation Process

Step 1: Identify Event and Purpose

Ask the user:

• What should happen automatically?
• When should it happen (which event)?
• What tool uses should trigger it (if PostToolUse)?

Step 2: Choose Hook Type

Three hook types:

• command: Execute shell commands/scripts
• validation: Validate file contents or project state
• notification: Send alerts or status updates

Step 3: Write Hook Configuration

Structure for hooks/hooks.json:

{
  "hooks": {
    "EventName": [
      {
        "matcher": "ToolName1|ToolName2",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/script.sh"
          }
        ]
      }
    ]
  }
}