Skill

diagnose

Diagnoses Claude Code hooks setup by checking active hooks, file permissions, dependencies (jq, python3, node), env vars, settings.json integration, and recent activity logs.

Bash

Python

Node

developer-tools

npx claudepluginhub yurukusa/claude-code-hooks --plugin claude-code-hooks

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Run a diagnostic check on the user's Claude Code hooks setup.

SKILL.md

Similar Skills

health-check

Runs comprehensive diagnostics on Claude Code environment: plugins, settings, hooks, MCP servers. Identifies issues, supports --fix and --verbose.

5 files5 tools

health-plugin

setup

Guides setup of Claude Code Hooks for production safety, selecting profiles (Minimal, Standard, Autonomous), configuring env vars like CC_CONTEXT_MISSION_FILE, and running verification tests.

claude-code-hooks

audit-hooks

Audits Claude Code hooks for config validity, script structure, matchers, env vars, decisions, and tests. Run after hook creation, before releases, or for periodic checks.

5 tools

claude-ecosystem

Stats

Stars10

Forks1

Last CommitMar 16, 2026

Used By2 plugins

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Diagnose Claude Code Hooks

Run a diagnostic check on the user's Claude Code hooks setup.

Checks to perform

Hook files exist and are executable

for hook in context-monitor.sh syntax-check.sh activity-logger.sh branch-guard.sh decision-warn.sh cdp-safety-check.sh error-gate.sh no-ask-human.sh proof-log-session.sh session-start-marker.sh; do
  if [ -f "${CLAUDE_PLUGIN_ROOT}/hooks/$hook" ]; then
    if [ -x "${CLAUDE_PLUGIN_ROOT}/hooks/$hook" ]; then
      echo "OK: $hook (executable)"
    else
      echo "WARN: $hook exists but not executable"
    fi
  else
    echo "MISSING: $hook"
  fi
done

Dependencies available

jq — required by most hooks
python3 — required by activity-logger, proof-log, context-monitor
node — optional, for JS syntax checking

Environment variables

Check if CC_ACTIVITY_LOG, CC_PROOF_LOG_DIR, CC_CONTEXT_MISSION_FILE are set
Report defaults if not set

Settings.json integration

Check ~/.claude/settings.json for hook entries
Report which hooks are wired and which are missing

Recent activity

Check if activity log exists and has recent entries
Check if proof-log directory has recent session logs

Output format

Present results as a health report:

=== Claude Code Hooks Health Check === Hooks: 8/10 active Deps: jq ✓ python3 ✓ node ✓ Env: 3/5 configured Activity: Last entry 2h ago Overall: HEALTHY (2 warnings)

List any warnings or errors with actionable fix instructions.

Diagnose Claude Code Hooks

Run a diagnostic check on the user's Claude Code hooks setup.

Checks to perform

Hook files exist and are executable

for hook in context-monitor.sh syntax-check.sh activity-logger.sh branch-guard.sh decision-warn.sh cdp-safety-check.sh error-gate.sh no-ask-human.sh proof-log-session.sh session-start-marker.sh; do
  if [ -f "${CLAUDE_PLUGIN_ROOT}/hooks/$hook" ]; then
    if [ -x "${CLAUDE_PLUGIN_ROOT}/hooks/$hook" ]; then
      echo "OK: $hook (executable)"
    else
      echo "WARN: $hook exists but not executable"
    fi
  else
    echo "MISSING: $hook"
  fi
done

Dependencies available
- jq — required by most hooks
- python3 — required by activity-logger, proof-log, context-monitor
- node — optional, for JS syntax checking
Environment variables
- Check if CC_ACTIVITY_LOG, CC_PROOF_LOG_DIR, CC_CONTEXT_MISSION_FILE are set
- Report defaults if not set
Settings.json integration
- Check ~/.claude/settings.json for hook entries
- Report which hooks are wired and which are missing
Recent activity
- Check if activity log exists and has recent entries
- Check if proof-log directory has recent session logs

Output format

Present results as a health report:

=== Claude Code Hooks Health Check ===
Hooks:     8/10 active
Deps:      jq ✓  python3 ✓  node ✓
Env:       3/5 configured
Activity:  Last entry 2h ago
Overall:   HEALTHY (2 warnings)

List any warnings or errors with actionable fix instructions.