Hooks Validator
The Hooks validator checks .claude/hooks/hooks.json files for schema compliance, event validity, and script references.
What It Checks
- hooks.json schema validation
- Valid event names (PreToolUse, PostToolUse, SessionStart, etc.)
- Hook type correctness
- Script file existence
- Matcher pattern syntax
Rules
This validator includes 3 rules. See the Hooks rules category for the complete list.
| Rule | Severity | Description |
|---|---|---|
| hooks-missing-script | error | Hook script not found |
| hooks-invalid-event | error | Invalid hook event name |
| hooks-invalid-config | error | Invalid hooks.json schema |
CLI Usage
bash
claudelint validate-hooks
claudelint validate-hooks --verboseSee Also
- Claude Code Hooks - Official hooks documentation
- Claude Code Hooks Integration - Using hooks with claudelint