Skip to main content
ClaudeWave
Skill1.3k repo starsupdated today

hook-management

Hook Management provides session-scoped control over ClaudeKit's event-driven hooks, including file guards, code quality checks, and project context injection. Use it to enable or disable specific hooks during a session, monitor their execution performance with color-coded alerts, and review profiling data when hooks are causing delays or other issues without affecting other sessions.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/a5c-ai/babysitter /tmp/hook-management && cp -r /tmp/hook-management/library/methodologies/claudekit/skills/hook-management ~/.claude/skills/hook-management
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Hook Management

## Overview

Session-scoped hook lifecycle management for ClaudeKit's event-driven hook system. Provides enable/disable/status controls with execution profiling and performance alerts.

## Hook Types

### PreToolUse Hooks
- **file-guard**: Blocks sensitive file access (195+ patterns)

### PostToolUse Hooks
- **typecheck-changed**: Type checking on modified files
- **lint-changed**: Linting on modified files
- **test-changed**: Testing related to modified files
- **check-comment-replacement**: Detects code replaced with comments
- **check-unused-parameters**: Detects unused function parameters

### UserPromptSubmit Hooks
- **codebase-map**: Invisible project context injection
- **thinking-level**: Reasoning enhancement (4 levels)

### Stop/SubagentStop Hooks
- **create-checkpoint**: Git-backed state snapshot
- **typecheck-project**: Full project type checking
- **lint-project**: Full project linting
- **test-project**: Full test suite execution
- **self-review**: Comprehensive change review

## Session Isolation

All hook changes are session-scoped. Disabling a hook only affects the current session and does not persist.

## Profiling

- Red alert: execution time > 5s
- Yellow warning: execution time > 3s
- Green: execution time < 3s
- Output size monitoring: flag > 10KB

## Commands

- `/hook:enable [hookName]` -- Enable a disabled hook
- `/hook:disable [hookName]` -- Disable a hook for this session
- `/hook:status` -- Show all hook states and profiling data

## When to Use

- When a hook is causing issues during a session
- To check performance of hook executions
- To temporarily bypass a hook for a specific operation

## Processes Used By

- `claudekit-orchestrator` (hook pipeline setup)
- `claudekit-safety-pipeline` (hook profiling)