Skip to main content
ClaudeWave
Skill79 repo starsupdated yesterday

hooks-check

The hooks-check skill validates the hooks configuration in `.claude/settings.json` and verifies that all referenced hook scripts exist, are executable, and output valid JSON. Use this skill when setting up or troubleshooting Claude's hook system to ensure PreToolUse, PostToolUse, and other event handlers are properly configured and functional.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/claude-world/director-mode-lite /tmp/hooks-check && cp -r /tmp/hooks-check/skills/hooks-check ~/.claude/skills/hooks-check
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Hooks Validator

Validate hooks configuration in `.claude/settings.json` and hook scripts.

---

## Validation Steps

### 1. Check settings.json
Verify `hooks` section exists and is valid.

### 2. Validate Hook Structure
```json
{
  "hooks": {
    "PreToolUse": [...],
    "PostToolUse": [...],
    "UserPromptSubmit": [...],
    "Stop": [...],
    "SubagentStop": [...],
    "SessionStart": [...],
    "SessionEnd": [...],
    "PreCompact": [...],
    "PostCompact": [...],
    "Notification": [...],
    "Elicitation": [...],
    "ElicitationResult": [...]
  }
}
```

### 3. Validate Each Hook Entry
- [ ] `type` is "command" or "prompt"
- [ ] If `type: "command"`: `command` path exists and script is executable
- [ ] If `type: "prompt"`: `prompt` string is non-empty
- [ ] `timeout` is positive integer if present (default: 60s command, 30s prompt)
- [ ] `once` is boolean if present

### 4. Validate Hook Scripts
- [ ] File exists and is executable
- [ ] Outputs valid JSON
- [ ] Has appropriate shebang

---

## Output Format

```markdown
## Hooks Validation Report

### Configuration Status: VALID / INVALID

### Configured Hooks
| Type | Matcher | Script | Status |
|------|---------|--------|--------|
| Stop | * | auto-loop-stop.sh | OK |

### Script Validation
| Script | Exists | Executable | Valid Output |
|--------|--------|------------|--------------|
| auto-loop-stop.sh | OK | OK | OK |

### Issues Found
1. [Issue and fix]
```

---

## Auto-Fix

- Make scripts executable
- Add missing shebang
- Create missing hook scripts