Skills
.Work. You
Rest

tool-hooks-doctor

Community

Diagnose Claude Code hooks and fix setups.

Software Engineering#Claude Code#settings.json#pre-tool#post-tool#skill-evolution#hook-diagnostics#runs/evolution
AuthorHeyvhuang
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill quickly verifies that Claude Code evolution hooks for skill-evolution are installed and enabled, and provides a ready-to-run fix. It helps ensure runs/evolution artifacts are produced and not lost due to misconfigurations.

Core Features & Use Cases

  • Health checks for hook installation: confirms presence of pre-tool.sh, post-bash.sh, post-tool.sh, and session-end.sh in the expected directory.
  • Configuration validation: checks both project-level and global settings.json for enabled hooks and correct mappings.
  • Guided remediation: provides explicit steps or commands to fix missing or disabled hooks and to restore the evolution loop.

Quick Start

To diagnose your environment, run the checks:

  • ls -la ~/.claude/skills/skill-evolution/hooks/ 2>/dev/null || true
  • grep -n "skill-evolution/hooks/pre-tool.sh" .claude/settings.json ~/.claude/settings.json 2>/dev/null || true
  • ls -la runs/evolution 2>/dev/null || true

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: tool-hooks-doctor
Download link: https://github.com/Heyvhuang/ship-faster/archive/main.zip#tool-hooks-doctor

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.