Validate Hooks

Name: Validate Hooks
Author: pdugan20

ASecurity

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.

12 stars
0 votes
0 copies
3 views
Added May 26, 2026

toolsbash

Works with

claude code

Security analysis

A100/100

Pro scans all 3 files and shows the line behind each finding

Scanned May 27, 2026

npx -y skills add pdugan20/claudelint --skill validate-hooks --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Validate Hooks?

Add the live security badge to your README. It updates with every re-scan.

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/pdugan20-validate-hooks/badge)](https://www.skillsdirectory.com/skills/pdugan20-validate-hooks)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

SKILL.md

---
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

```bash
claudelint validate-hooks
claudelint validate-hooks --path /path/to/hooks.json
```

## See Also

- [validate-all](../validate-all/SKILL.md) - Run all validators