| name | validate-hooks |
| description | Validates Claude Code hooks.json files for schema, events, and commands. Use when user asks to "check my hooks", "validate hooks.json", "hook errors", "why isn't my hook firing", or "hook event types". Validates hook events, types (command, prompt, agent), matcher patterns, and command script references. |
| version | 1.0.0 |
| argument-hint | [flags] |
| allowed-tools | ["Bash(claudelint:*)"] |
Validate Hooks
Runs claudelint validate-hooks to validate .claude/hooks/hooks.json files.
Usage
claudelint validate-hooks $ARGUMENTS
Options
--path <path> - Custom path to hooks.json
--verbose - Show detailed output
--warnings-as-errors - Treat warnings as errors
What Gets Validated
- JSON syntax
- Hook events (tool-use, user-prompt-submit, etc.)
- Hook types (command, prompt, agent)
- Matcher validation (tool names, regex patterns)
- Command script file existence
Examples
claudelint validate-hooks
claudelint validate-hooks --path /path/to/hooks.json
See Also