tool-hooks-doctor

Diagnose Claude Code evolution hook installation and enablement status.

1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/mshaheerz/hive-mind --skill tool-hooks-doctor-mshaheerz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tool-hooks-doctor
Source: https://github.com/mshaheerz/hive-mind/tree/main/agent-skills/tool-hooks-doctor
Command: npx skills add https://github.com/mshaheerz/hive-mind --skill tool-hooks-doctor-mshaheerz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill quickly checks if Claude Code's evolution hooks are correctly installed and enabled, providing immediate feedback and a copy-paste fix when runs or evolution artifacts are unexpectedly missing.

Core Features & Use Cases

  • Hook Verification: Checks for the presence of necessary hook scripts and their enablement in settings.
  • Diagnostic Reporting: Reports the status of hook scripts and settings as OK, PARTIAL, or MISSING.
  • Automated Fix: Offers to install project-level hooks with user confirmation.
  • Use Case: When you expect your AI agent to generate evolution artifacts after running a task, but no output appears in the runs/evolution directory, this Skill helps diagnose if the underlying hook mechanism is broken.

Quick Start

Run the tool-hooks-doctor skill to check if Claude Code hooks are installed and enabled.

Frequently Asked Questions about tool-hooks-doctor

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

FAQPage Schema
Why are my Claude Code evolution hooks not generating output in the runs directory?

Claude Code evolution hooks may not be generating output because the underlying hook scripts are missing from `~/.claude/skills/skill-evolution/hooks/` or their configuration is absent from project and global settings. This Skill diagnoses both conditions and reports the status as OK, PARTIAL, or MISSING.

How do I check if Claude Code hooks are installed and enabled?

To check if Claude Code hooks are installed and enabled, run this diagnostic Skill to verify the presence of hook scripts in the local skills directory and confirm their enablement within your project or global settings file, providing an immediate status report.

Can I automatically fix missing Claude Code hook configurations?

Yes, you can automatically fix missing Claude Code hook configurations. After diagnosing the installation status, this Skill offers an automated fix that installs the necessary project-level hooks by executing a Python script, subject to your explicit confirmation.

What does a PARTIAL status mean when diagnosing Claude Code hook issues?

A PARTIAL status when diagnosing Claude Code hook issues means that either the hook scripts exist in the designated directory but lack proper enablement in settings, or the settings are configured but the corresponding hook script files are missing.

Do I need Python to install project-level evolution hooks for Claude Code?

Yes, you need Python installed in your environment to apply the automated fix. The Skill utilizes a Python script to install the necessary project-level evolution hooks when the diagnostic report indicates they are missing or incorrectly configured.

How do Claude Code hook settings affect skill evolution artifacts?

Claude Code hook settings directly control skill evolution by triggering scripts that generate evolution artifacts after a task runs. If these settings are missing or the hook scripts are uninstalled, the expected output will not appear in the `runs/evolution` directory.