validate-hooks

对Claude Code hooks.json文件的Schema、事件与命令进行验证。当用户提出“检查我的钩子”“验证hooks.json”“钩子报错”“我的钩子为什么没有触发”或“钩子事件类型”的需求时使用。验证钩子事件、事件类型（命令、提示词、智能体）、匹配器模式，以及命令脚本的引用。

SKILL.md

--- frontmatter

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

bash

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