@yeongjaeyou/claude-code-config 0.15.0 → 0.17.0

package/.claude/skills/hook-creator/SKILL.md

@@ -0,0 +1,88 @@
+---
+name: hook-creator
+description: Create and configure Claude Code hooks for customizing agent behavior. Use when the user wants to (1) create a new hook, (2) configure automatic formatting, logging, or notifications, (3) add file protection or custom permissions, (4) set up pre/post tool execution actions, or (5) asks about hook events like PreToolUse, PostToolUse, Notification, etc.
+---
+
+# Hook Creator
+
+Create Claude Code hooks that execute shell commands at specific lifecycle events.
+
+## Hook Creation Workflow
+
+1. **Identify the use case** - Determine what the hook should accomplish
+2. **Select the appropriate event** - Choose from available hook events (see references/hook-events.md)
+3. **Design the hook command** - Write shell command that processes JSON input from stdin
+4. **Configure the matcher** - Set tool/event filter (use `*` for all, or specific tool names like `Bash`, `Edit|Write`)
+5. **Choose storage location** - User settings (`~/.claude/settings.json`) or project (`.claude/settings.json`)
+6. **Test the hook** - Verify behavior with a simple test case
+
+## Hook Configuration Structure
+
+```json
+{
+  "hooks": {
+    "<EventName>": [
+      {
+        "matcher": "<ToolPattern>",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "<shell-command>"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Common Patterns
+
+### Reading Input Data
+
+Hooks receive JSON via stdin. Use `jq` to extract fields:
+
+```bash
+# Extract tool input field
+jq -r '.tool_input.file_path'
+
+# Extract with fallback
+jq -r '.tool_input.description // "No description"'
+
+# Conditional processing
+jq -r 'if .tool_input.file_path then .tool_input.file_path else empty end'
+```
+
+### Exit Codes for PreToolUse
+
+- `0` - Allow the tool to proceed
+- `2` - Block the tool and provide feedback to Claude
+
+### Matcher Patterns
+
+- `*` - Match all tools
+- `Bash` - Match only Bash tool
+- `Edit|Write` - Match Edit or Write tools
+- `Read` - Match Read tool
+
+## Quick Examples
+
+**Log all bash commands:**
+```bash
+jq -r '"\(.tool_input.command)"' >> ~/.claude/bash-log.txt
+```
+
+**Auto-format TypeScript after edit:**
+```bash
+jq -r '.tool_input.file_path' | { read f; [[ "$f" == *.ts ]] && npx prettier --write "$f"; }
+```
+
+**Block edits to .env files:**
+```bash
+python3 -c "import json,sys; p=json.load(sys.stdin).get('tool_input',{}).get('file_path',''); sys.exit(2 if '.env' in p else 0)"
+```
+
+## Resources
+
+- **Hook Events Reference**: See `references/hook-events.md` for detailed event documentation with input/output schemas
+- **Example Configurations**: See `references/examples.md` for complete, tested hook configurations

package/.claude/skills/hook-creator/references/examples.md

@@ -0,0 +1,339 @@
+# Hook Examples
+
+Complete, tested hook configurations for common use cases.
+
+## Logging Hooks
+
+### Log All Bash Commands
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '\"\\(.tool_input.command) - \\(.tool_input.description // \"No description\")\"' >> ~/.claude/bash-command-log.txt"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Log All File Edits
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '\"[\\(now | strftime(\"%Y-%m-%d %H:%M:%S\"))] \\(.tool_name): \\(.tool_input.file_path)\"' >> ~/.claude/edit-log.txt"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Auto-Formatting Hooks
+
+### Format TypeScript Files
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.tool_input.file_path' | { read file_path; if echo \"$file_path\" | grep -q '\\.tsx\\?$'; then npx prettier --write \"$file_path\" 2>/dev/null; fi; }"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Format Python Files with Black
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.tool_input.file_path' | { read f; [[ \"$f\" == *.py ]] && black \"$f\" 2>/dev/null; }"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Format Go Files
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.tool_input.file_path' | { read f; [[ \"$f\" == *.go ]] && gofmt -w \"$f\"; }"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## File Protection Hooks
+
+### Block Edits to Sensitive Files
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 -c \"import json, sys; data=json.load(sys.stdin); path=data.get('tool_input',{}).get('file_path',''); blocked=['.env', 'package-lock.json', '.git/', 'secrets']; sys.exit(2 if any(p in path for p in blocked) else 0)\""
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Block Modifications to Production Directory
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write|Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.tool_input | .file_path // .command // \"\"' | grep -q '/prod/' && echo 'BLOCKED: Cannot modify production files' && exit 2 || exit 0"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Notification Hooks
+
+### macOS Desktop Notification
+
+```json
+{
+  "hooks": {
+    "Notification": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.message' | xargs -I{} osascript -e 'display notification \"{}\" with title \"Claude Code\"'"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Linux Desktop Notification
+
+```json
+{
+  "hooks": {
+    "Notification": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.message' | xargs -I{} notify-send 'Claude Code' '{}'"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Sound Notification (macOS)
+
+```json
+{
+  "hooks": {
+    "Notification": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "afplay /System/Library/Sounds/Glass.aiff"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Validation Hooks
+
+### Validate JSON Before Write
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -e '.tool_input | select(.file_path | endswith(\".json\")) | .content' | jq . > /dev/null 2>&1 || { echo 'Invalid JSON content'; exit 2; }"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Lint TypeScript Before Commit
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.tool_input.command' | grep -q 'git commit' && npx eslint . --max-warnings 0 || exit 0"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Session Hooks
+
+### Initialize Environment on Session Start
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "[ -f .claude-env ] && source .claude-env"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Cleanup on Session End
+
+```json
+{
+  "hooks": {
+    "SessionEnd": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "rm -f /tmp/claude-session-* 2>/dev/null; exit 0"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Multiple Hooks Example
+
+Combine multiple hooks in one configuration:
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 -c \"import json,sys; p=json.load(sys.stdin).get('tool_input',{}).get('file_path',''); sys.exit(2 if '.env' in p else 0)\""
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.tool_input.file_path' | { read f; [[ \"$f\" == *.ts ]] && npx prettier --write \"$f\" 2>/dev/null; exit 0; }"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "afplay /System/Library/Sounds/Glass.aiff"
+          }
+        ]
+      }
+    ]
+  }
+}
+```

package/.claude/skills/hook-creator/references/hook-events.md

@@ -0,0 +1,193 @@
+# Hook Events Reference
+
+## Event Overview
+
+| Event | Trigger | Can Block | Typical Use |
+|-------|---------|-----------|-------------|
+| PreToolUse | Before tool execution | Yes (exit 2) | Validation, blocking |
+| PostToolUse | After tool completion | No | Formatting, logging |
+| PermissionRequest | Permission dialog shown | Yes | Auto-allow/deny |
+| UserPromptSubmit | User submits prompt | No | Pre-processing |
+| Notification | Claude sends notification | No | Custom alerts |
+| Stop | Claude finishes responding | No | Post-processing |
+| SubagentStop | Subagent task completes | No | Subagent cleanup |
+| PreCompact | Before compact operation | No | Pre-compact actions |
+| SessionStart | Session starts/resumes | No | Initialization |
+| SessionEnd | Session ends | No | Cleanup |
+
+## PreToolUse
+
+Runs before tool calls. Can block execution.
+
+**Input Schema:**
+```json
+{
+  "tool_name": "Bash",
+  "tool_input": {
+    "command": "ls -la",
+    "description": "List files"
+  }
+}
+```
+
+**Exit Codes:**
+- `0` - Allow tool to proceed
+- `2` - Block tool, stdout sent as feedback to Claude
+
+**Common tool_input fields by tool:**
+- `Bash`: `command`, `description`
+- `Edit`: `file_path`, `old_string`, `new_string`
+- `Write`: `file_path`, `content`
+- `Read`: `file_path`
+- `Glob`: `pattern`, `path`
+- `Grep`: `pattern`, `path`
+
+## PostToolUse
+
+Runs after tool calls complete.
+
+**Input Schema:**
+```json
+{
+  "tool_name": "Edit",
+  "tool_input": {
+    "file_path": "/path/to/file.ts"
+  },
+  "tool_response": "File edited successfully"
+}
+```
+
+**Use Cases:**
+- Auto-formatting edited files
+- Logging tool results
+- Triggering dependent actions
+
+## PermissionRequest
+
+Runs when permission dialog is shown.
+
+**Input Schema:**
+```json
+{
+  "tool_name": "Bash",
+  "tool_input": {
+    "command": "npm install"
+  },
+  "permission_type": "execute"
+}
+```
+
+**Exit Codes:**
+- `0` - Let user decide
+- `1` - Auto-deny
+- `2` - Auto-approve
+
+## Notification
+
+Runs when Claude sends notifications.
+
+**Input Schema:**
+```json
+{
+  "message": "Waiting for your input",
+  "type": "input_required"
+}
+```
+
+**Use Cases:**
+- Custom desktop notifications
+- Slack/Discord alerts
+- Sound notifications
+
+## UserPromptSubmit
+
+Runs when user submits a prompt, before Claude processes it.
+
+**Input Schema:**
+```json
+{
+  "prompt": "Help me fix this bug",
+  "session_id": "abc123"
+}
+```
+
+**Use Cases:**
+- Prompt logging
+- Pre-processing
+- Context injection
+
+## Stop
+
+Runs when Claude finishes responding.
+
+**Input Schema:**
+```json
+{
+  "stop_reason": "end_turn",
+  "session_id": "abc123"
+}
+```
+
+**Use Cases:**
+- Session logging
+- Cleanup tasks
+- Metrics collection
+
+## SubagentStop
+
+Runs when subagent (Task tool) tasks complete.
+
+**Input Schema:**
+```json
+{
+  "subagent_type": "Explore",
+  "result": "Found 5 matching files"
+}
+```
+
+## PreCompact
+
+Runs before Claude compacts conversation context.
+
+**Input Schema:**
+```json
+{
+  "reason": "context_limit",
+  "current_tokens": 50000
+}
+```
+
+## SessionStart
+
+Runs when Claude Code starts or resumes a session.
+
+**Input Schema:**
+```json
+{
+  "session_id": "abc123",
+  "is_resume": false,
+  "project_dir": "/path/to/project"
+}
+```
+
+**Use Cases:**
+- Environment setup
+- Loading project config
+- Starting background services
+
+## SessionEnd
+
+Runs when Claude Code session ends.
+
+**Input Schema:**
+```json
+{
+  "session_id": "abc123",
+  "end_reason": "user_exit"
+}
+```
+
+**Use Cases:**
+- Cleanup resources
+- Save session state
+- Stop background services