Debug Hooks

Works through a systematic workflow to debug hooks that misfire or misbehave.

Works with setup

Test report

Verdict
Works with setup
Score
6.8/10
Tested
Jul 13, 2026
Environment
Claude Code 2.x (agent harness)
Upstream re-checked
Jul 18, 2026 · c7c09da

Tested a lowercase 'postToolUse' vs case-sensitive 'PostToolUse' settings.json key that silently prevents a Write hook from ever firing. Installs verbatim with no surgery; SKILL.md frontmatter is valid and the workflow is pure-bash with no hidden deps, though its description ('hooks') is broad enough to collide with generic React/git-hook prompts. A/B: both skill and no-skill arms independently nailed the exact root cause, one-line fix, and confirmation step, so the skill delivered no diagnostic lift on this task.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 5/5
  • Triggers reliably 3/5
  • Output vs. baseline 5/10
  • Docs & honesty 4/5

What Debug Hooks does

Systematic hook debugging workflow. Use when hooks aren't firing, producing wrong output, or behaving unexpectedly.

How to install Debug Hooks

git clone https://github.com/parcadei/Continuous-Claude-v3
cd Continuous-Claude-v3
mkdir -p ~/.claude/skills
cp -r .claude/skills/debug-hooks ~/.claude/skills/debug-hooks

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger Debug Hooks

  • /debug-hooks Works through a systematic workflow to debug hooks that misfire or misbehave.

It also activates on plain-language prompts like these:

  • This hook isn't firing, help me debug it
  • My pre-commit hook produces wrong output, fix it
  • Debug why this Claude Code hook behaves unexpectedly

Frequently asked questions

Is the Debug Hooks skill free?
Yes. The skill itself is free from parcadei/Continuous-Claude-v3. SkillProof publishes the install command and an independent test verdict at no cost.
Does Debug Hooks work with Claude Code?
We tested it with Claude Code 2.x (agent harness) on Jul 13, 2026. Verdict: Works with setup. Tested a lowercase 'postToolUse' vs case-sensitive 'PostToolUse' settings.json key that silently prevents a Write hook from ever firing. Installs verbatim with no surgery; SKILL.md frontmatter is valid and the workflow is pure-bash with no hidden deps, though its description ('hooks') is broad enough to collide with generic React/git-hook prompts. A/B: both skill and no-skill arms independently nailed the exact root cause, one-line fix, and confirmation step, so the skill delivered no diagnostic lift on this task.
What is the Debug Hooks SkillProof Score?
6.8/10 — installs cleanly 5/5, triggers reliably 3/5, output vs. baseline 5/10, docs & honesty 4/5.
How do I install Debug Hooks?
Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use Debug Hooks with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.