hooks-doc

Document Claude Code hooks lifecycle events, configurations, matchers, and schemas.

1|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/hlibkoval/claudemd --skill hooks-doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hooks-doc
Source: https://github.com/hlibkoval/claudemd/tree/main/skills/hooks-doc
Command: npx skills add https://github.com/hlibkoval/claudemd --skill hooks-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides the complete official Claude Code hooks documentation in a single, searchable unit to help developers understand hook lifecycle, events, matcher patterns, and decision logic.

Core Features & Use Cases

  • Comprehensive hooks reference covering lifecycle, input/output schemas, and configuration options.
  • Practical examples and guidance for building and debugging hook configurations across sessions and tool calls.
  • Quick access to linked references for in-depth details and advanced features like async, HTTP, and MCP tool hooks.

Quick Start

Open the Hooks Reference to explore all events, schemas, and examples locally.

Frequently Asked Questions about hooks-doc

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

FAQPage Schema
What are Claude Code hooks and how do they work?

Claude Code hooks are lifecycle event triggers that execute custom logic during sessions, tool calls, and MCP interactions. They use matcher patterns and input/output schemas to intercept and modify behavior at specific execution points across the development workflow.

How do I configure hooks for Claude Code tool calls and sessions?

Configuring hooks requires defining event matchers and schemas in your Claude Code settings. You specify lifecycle events, set matcher patterns to target specific tool calls, and define input/output schemas to control how the hook executes and returns data during active sessions.

Can I use Claude Code hooks with MCP interactions and async HTTP requests?

Yes, Claude Code hooks support MCP tool interactions, async execution, and HTTP requests. The official documentation covers advanced configurations for routing MCP tool calls through hooks and handling asynchronous HTTP responses during lifecycle events.

How do I debug Claude Code hook configurations when they fail to trigger?

Debugging Claude Code hooks involves validating your event matchers, checking input/output schemas against the official reference, and verifying lifecycle event bindings. The documentation provides schema definitions and practical examples to identify configuration mismatches causing hooks not to fire.

What lifecycle events are available for Claude Code hooks?

Claude Code hooks lifecycle events cover session start, tool call interception, and MCP interaction boundaries. The official reference documents all available events with their specific input/output schemas, allowing developers to bind custom logic to exact execution points in the workflow.