list-hooks

List configured hooks from settings.json with events, matchers, and scripts.

2|1|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/enbiyagoral/.claude --skill list-hooks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: list-hooks
Source: https://github.com/enbiyagoral/.claude/tree/main/.claude/skills/list-hooks
Command: npx skills add https://github.com/enbiyagoral/.claude --skill list-hooks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

List all configured hooks from settings.json and their events, matchers, and scripts.

Core Features & Use Cases

  • Read the settings.json and parse the hooks object to enumerate active hook configurations.
  • Display each hook's event, matcher pattern, and script names, with the type of hook (PreToolUse, PostToolUse, etc.).
  • Detect and report local-only hooks from settings.local.json and identify orphaned scripts in hooks/scripts that are not referenced.
  • Provide a clear, structured output that can be reviewed or pasted into documentation for audit or debugging.

Quick Start

Run the List hooks command to display all active hooks and any local or orphaned entries.

Frequently Asked Questions about list-hooks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list all configured hooks in settings.json for Claude projects?

List all configured hooks by parsing the settings.json file to enumerate active hook configurations, displaying each hook's event, matcher pattern, and script names for review. It generates a structured catalog of all active hooks.

Can I detect orphaned scripts in my hooks directory that are not referenced?

Yes, you can detect orphaned scripts by scanning the hooks/scripts directory and cross-referencing them against parsed settings.json configurations to identify unreferenced scripts, providing a clear report for cleanup or debugging.

How do I audit local hook overrides in settings.local.json?

Audit local hook overrides by detecting and reporting local-only hooks from settings.local.json, comparing them against the main settings.json to identify discrepancies and active local configurations for debugging.

What is the best way to catalog Claude hooks and their matchers for documentation?

Catalog Claude hooks and their matchers by parsing JSON hook configurations to generate a structured, formatted output that can be reviewed or pasted directly into project documentation for auditing active events and scripts.

Does this tool work with both PreToolUse and PostToolUse hook events?

Yes, it works with PreToolUse, PostToolUse, and other hook types by reading the settings.json hooks object to display each hook's event type, matcher pattern, and associated script names in the generated catalog.