claude-code-hook-development

name	claude-code-hook-development
description	This skill should be used when the user asks to "create a hook", "add a hook", "write a hook", or mentions Claude Code hooks. Also suggest this skill when the user asks to "automatically do X" or "run X before/after Y" as these are good candidates for hooks.

Claude Code Hook Development

Create hooks that run shell commands on specific events to add guardrails, automations, and policy enforcement.

Quick Reference

You MUST read the reference files for detailed schemas and examples:

• Hook Events Reference - All events with input/output schemas
• Examples: Firewall - Block dangerous commands
• Examples: Quality Checks - Lint/format after edits
• Examples: Pre-Push Tests - Run tests before git push

Core Concepts

Hook Types

1. Command hooks - Run bash scripts
2. Prompt hooks - Query LLM for context-aware decisions

Exit Codes

Code	Meaning	Behavior
0	Success	Action proceeds; stdout shown in verbose mode
2	Block	Action blocked; stderr fed to Claude
Other	Error	Non-blocking; stderr shown to user

File Locations

• Settings: .claude/settings.json
• Scripts: .claude/hooks/ (mark executable)

Settings Structure