MohamedAbdallah-14

Hook Doctor — Development skill for Claude Code

Development community

Validate ~/.claude/settings.json hook references against this repo's registry.

How to install Hook Doctor

Installs to ~/.claude/commands/mohamedabdallah-14-awesome-claude-hooks-hook-doctor.md

Terminal
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/MohamedAbdallah-14/awesome-claude-hooks/HEAD/.claude/commands/hook-doctor.md -o ~/.claude/commands/mohamedabdallah-14-awesome-claude-hooks-hook-doctor.md

Restart Claude Code, or start a new session, for it to be picked up.

What Hook Doctor does


description: Validate ~/.claude/settings.json hook references against this repo's registry allowed-tools: Bash, Read

Run `bash scripts/hook-doctor.sh` and summarize the report for the user.

The doctor reports:

  • Hooks referenced by absolute path that no longer exist on disk.
  • Hooks under unknown event names.
  • Duplicated commands within the same event (would run the same hook multiple times).
  • Hooks whose path is inside this repo but the file no longer matches its registry entry (eve

Alternatives in Development

Full documentation available on GitHub

View Source Repository