# Hooks Check

> Validate hooks configuration and scripts

- Skill: `majiayu000/hooks-check` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/hooks-check`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/hooks-check/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/hooks-check

---


# 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