🎯

claude-code-hooks

🎯Skill

from 0xdarkmatter/claude-mods

What it does

Enables custom script execution before and after Claude Code tool invocations with flexible matching and event-driven hooks.

📦

Part of

0xdarkmatter/claude-mods(36 items)

claude-code-hooks

Installation

ConfigurationMCP configuration (may be incomplete)

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
 ...

📖 Extracted from docs: 0xdarkmatter/claude-mods

Need more details? View full documentation on GitHub →

12Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

"Claude Code hook system for pre/post tool execution. Triggers on: hooks, PreToolUse, PostToolUse, hook script, tool validation, audit logging."

Overview

# Claude Code Hooks

Execute custom scripts before/after Claude Code tool invocations.

Quick Reference

| Event | When | Has Matcher |

|-------|------|-------------|

| PreToolUse | Before tool execution | Yes |

| PostToolUse | After tool completes | Yes |

| PermissionRequest | Permission dialog shown | Yes |

| Notification | Notifications sent | Yes |

| UserPromptSubmit | User submits prompt | No |

| Stop | Agent finishes | No |

| SubagentStop | Subagent finishes | No |

| PreCompact | Before context compaction | No |

| SessionStart | Session begins/resumes | No |

| SessionEnd | Session ends | No |

Basic Configuration

Add to ~/.claude/settings.json or .claude/settings.local.json:

```json

{

"hooks": {

"PreToolUse": [{

"matcher": "Bash",

"hooks": [{

"type": "command",

"command": "$CLAUDE_PROJECT_DIR/hooks/validate.sh",

"timeout": 5000

}]

}

```

Matcher Patterns

| Pattern | Matches |

|---------|---------|

| "Write" | Only Write tool |

| "*" or "" | All tools |

| "mcp__*" | All MCP tools |

| "Bash" | Bash commands |

Hook Script Requirements

```bash

#!/bin/bash

# Receives JSON via stdin: { "tool_name": "...", "tool_input": {...} }

INPUT=$(cat)

TOOL=$(echo "$INPUT" | jq -r '.tool_name')

# Exit codes:

# 0 = Success (continue)

# 2 = Block with error (stderr shown to Claude)

# Other = Non-blocking error

```

Common Use Cases

| Use Case | Event | Example |

|----------|-------|---------|

| Validate inputs | PreToolUse | Block dangerous commands |

| Audit logging | PostToolUse | Log all tool usage |

| Custom approval | PermissionRequest | Slack notification |

| Session init | SessionStart | Load project context |

Security Checklist

[ ] Quote all variables: "$VAR" not $VAR
[ ] Validate paths (no .. traversal)
[ ] Use $CLAUDE_PROJECT_DIR for paths
[ ] Set reasonable timeouts
[ ] Handle jq parsing errors

Troubleshooting

```bash

# Debug hook loading

claude --debug

# List registered hooks

/hooks

# Test script manually

echo '{"tool_name":"Bash"}' | ./hooks/validate.sh

```

Official Documentation

https://code.claude.com/docs/en/hooks - Hooks reference
https://code.claude.com/docs/en/settings - Settings configuration

Additional Resources

./references/hook-events.md - All events with input/output schemas
./references/configuration.md - Advanced config patterns
./references/security-patterns.md - Production security

---

See Also: claude-code-debug for troubleshooting, claude-code-headless for CLI automation

More from this repository10

🎯

python-async-patterns🎯Skill

python-async-patterns skill from 0xdarkmatter/claude-mods

🎯

container-orchestration🎯Skill

Automates deployment, scaling, and management of containerized applications across multiple hosts using advanced orchestration strategies and best practices.

🎯

file-search🎯Skill

file-search skill from 0xdarkmatter/claude-mods

🎯

claude-code-debug🎯Skill

claude-code-debug skill from 0xdarkmatter/claude-mods

🎯

tailwind-patterns🎯Skill

Provides quick, practical Tailwind CSS utility class references and responsive design patterns for rapid frontend development.

🎯

security-patterns🎯Skill

Provides comprehensive security patterns and OWASP guidelines for preventing common web application vulnerabilities across different programming languages.

🎯

find-replace🎯Skill

find-replace skill from 0xdarkmatter/claude-mods

🎯

python-pytest-patterns🎯Skill

python-pytest-patterns skill from 0xdarkmatter/claude-mods

🎯

claude-code-templates🎯Skill

claude-code-templates skill from 0xdarkmatter/claude-mods

🎯

testing-patterns🎯Skill

Explores universal testing strategies and patterns, covering test pyramid, types, naming conventions, and test doubles across programming languages.