skills.rest
marcusgoll
marcusgollCOMMUNITY
Explore all skills by this author →
Website𝕏@marcusgollGitHub

diagnose-hooks

Diagnose and resolve Claude Code plugin hook errors like PreToolUse and PostToolUse failures.

Updated Jan 23, 2026
Search Tags:#debugging#claude code#plugin troubleshooting#hook errors#python alias#pre tool use#post tool use
One-click install
npx skills add https://github.com/marcusgoll/deep-loop-plugin --skill diagnose-hooks
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: diagnose-hooks
Source: https://github.com/marcusgoll/deep-loop-plugin/tree/main/skills/diagnose-hooks
Command: npx skills add https://github.com/marcusgoll/deep-loop-plugin --skill diagnose-hooks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the frustration of broken Claude Code plugin hooks, which cause plugins to fail silently or throw confusing PreToolUse/PostToolUse error messages with no clear fix path.

Core Features & Use Cases

  • Step-by-Step Diagnosis: Guides you through checking Python aliases, hook configuration, enabled plugins, and manual hook testing to pinpoint the root cause of failures.
  • Common Fix Library: Provides pre-defined solutions for frequent issues like missing python3 executables, missing Python modules, permission errors, and hook timeouts.
  • Use Case: If your security guidance plugin stopped sending write-time reminders after a system update, use this Skill to quickly identify and resolve the underlying hook failure.

Quick Start

Use the diagnose-hooks skill to find and fix the PreToolUse hook error you are seeing with your installed Claude Code plugins.

Frequently Asked Questions about diagnose-hooks

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

FAQPage Schema
Why does my Claude Code PreToolUse hook error fail silently after a system update?▼

Hook errors usually occur from misconfigured Python aliases, missing dependencies, or incorrect timeout settings. This skill guides you through checking python3 executables, validating hook configurations, and testing plugins manually to pinpoint the root cause of silent failures.

How do I fix PostToolUse hook errors in my Claude Code plugins?▼

Resolve PostToolUse hook errors by following step-by-step diagnosis of Python aliases, hook configuration, and manual hook testing. The skill supplies common fixes for missing python3 executables, absent modules, permission errors, and improper timeout settings.

What causes Claude Code plugin hooks to stop functioning without error messages?▼

Silent hook failures typically arise from misconfigured Python aliases, missing dependencies, or permission issues. This skill diagnoses these exact scenarios by validating hook configurations, checking python3 availability, and testing enabled plugins manually.

Does this troubleshooting process work for Python alias misconfigurations in Claude Code?▼

Yes, the skill specifically diagnoses misconfigured Python aliases by checking for missing python3 executables and validating alias resolution. It applies to scenarios where hooks fail due to incorrect Python path configurations.

How do I check if a hook timeout is causing my Claude Code plugin to fail?▼

Diagnose hook timeouts by inspecting your Claude Code timeout configurations. This skill identifies incorrect timeout settings alongside permission errors and missing modules to resolve PreToolUse and PostToolUse plugin failures.

Related Skills

Explore More Software Engineering Skills→
OpenSenseNovaOpenSenseNova
4.9k

sn-ppt-doctor

Inspects current Python and identifies missing or outdated packages for React projects.

Official
Basic
PsychQuantPsychQuant

plugin-health

Diagnose and resolve common issues with installed Claude Code plugins.

Official
Advanced
MinhThang1009MinhThang1009
15

hook-development

Design, implement, and validate Claude Code plugin hooks for event-driven automation.

Community
Advanced
Cogni-AI-OUCogni-AI-OU

robust-commands

Detect missing commands, install dependencies, and retry with fallback alternatives.

Official
Advanced