Claude Code Hooks Agent Skill

Claude Code Hooks

<p align="center"> <img src="!/claude-speaking.svg" alt="Claude Code mascot speaking" width="168" height="108"> </p> <p align="center"> <img src="!/repo-description.svg" alt="Mouse click on PreToolUse, Keyboard on PostToolUse, Human voice on other hooks" height="56"> </p>

Demo Video + Presentation

<p> <a href="https://youtu.be/6_y3AtkgjqA"><img src="!/pill-youtube-red.svg" alt="YouTube" height="36"></a>&nbsp; <a href="presentation/index.html"><img src="!/pill-slides.svg" alt="Slides" height="36"></a> </p> <p> <a href="https://youtu.be/MnpOsTEDzeY"><img src="!/thumbnail/video-2.jpg" alt="two-video" width="49%"></a>&nbsp; <a href="https://youtu.be/6_y3AtkgjqA"><img src="!/thumbnail/video-1.jpg" alt="one-video" width="49%"></a> </p>

Installation

<p> <a href="install/README-mac.md"><img src="!/pill-mac.svg" alt="Mac" height="36"></a>&nbsp; <a href="install/README-linux.md"><img src="!/pill-linux.svg" alt="Linux" height="36"></a>&nbsp; <a href="install/README-windows.md"><img src="!/pill-windows.svg" alt="Windows" height="36"></a> </p>

Step 1. Start Claude Code:

claude

Step 2. Send a prompt (e.g., Hi) — you'll hear a sound on session start, tool use, agent response, and more.

Common Errors

If you don't follow the prerequisites, you will see the following error on claude code start

SessionStart:startup hook error

Changelog

new hook addition changelogs only

Date	Hooks	Changes	Claude Code Version	Demo
Jun 04, 2026	30	Added MessageDisplay	v2.1.152
Jun 04, 2026	29	Added PostToolBatch	docs
Jun 04, 2026	28	Added UserPromptExpansion	docs
Mar 31, 2026	27	Added PermissionDenied	v2.1.88
Mar 26, 2026	26	Added TaskCreated	v2.1.84	Demo 4
Mar 25, 2026	25	Added CwdChanged, FileChanged	v2.1.83
Mar 18, 2026	23	Added StopFailure	v2.1.78
Mar 14, 2026	22	Added PostCompact, Elicitation, ElicitationResult	v2.1.76
Mar 5, 2026	19	Added InstructionsLoaded	v2.1.69
Feb 21, 2026	18	Added WorktreeCreate and WorktreeRemove	v2.1.50
Feb 20, 2026	16	Added ConfigChange	v2.1.49
Feb 6, 2026	15	Added TeammateIdle and TaskCompleted	v2.1.33
—	13	Added PostToolUseFailure	—	Demo 3
Jan 17, 2026	12	Added Setup	v2.1.10
Jan 7, 2026	12	Added subagent hooks: PreToolUse, PostToolUse, Stop	v2.1.0
Nov 18, 2025	11	Added PermissionRequest	v2.0.45	Demo 2
Nov 17, 2025	10	Added SubagentStart	v2.0.43
Nov 10, 2025	9	Added Notification	v2.0.37	Demo 1
Jul 28, 2025	8	Added SessionStart	v1.0.62
Jul 16, 2025	7	Added UserPromptSubmit	v1.0.54
Jul 10, 2025	6	Added PreCompact	v1.0.48
Jul 2, 2025	5	Split Stop into Stop and SubagentStop	v1.0.41
Jun 30, 2025	4	Initial release: PreToolUse, PostToolUse, Stop, SessionEnd	v1.0.38

Not in Official Docs

Links

<p> <a href="https://www.youtube.com/watch?v=vgfdSUbz_b0"><img src="!/pill-youtube.svg" alt="YouTube" height="36"></a>&nbsp; <a href="https://www.linkedin.com/posts/shanraisshan_claudecode-aicoding-voicehooks-activity-7393305703697805312-4gl0"><img src="!/pill-linkedin.svg" alt="LinkedIn" height="36"></a>&nbsp; <a href="https://www.reddit.com/r/ClaudeCode/comments/1otaf7f/i_just_made_claude_code_speak_using_hooks/"><img src="!/pill-reddit.svg" alt="Reddit" height="36"></a>&nbsp; <a href="https://x.com/shanraisshan/status/1987817251966513620"><img src="!/pill-x.svg" alt="X" height="36"></a>&nbsp; <a href="https://medium.com/@shanraisshan/claude-code-just-got-a-voice-%25EF%25B8%258F-51008157305b"><img src="!/pill-medium.svg" alt="Medium" height="36"></a> </p>

Other Repos

<table> <tr> <td align="center" width="140"> <a href="https://github.com/shanraisshan/codex-cli-hooks"><img src="!/codex-speaking.svg" alt="Codex CLI Hooks" width="64" height="64"></a><br> <a href="https://github.com/shanraisshan/codex-cli-hooks"><strong>Codex CLI<br>Hooks</strong></a> </td> <td align="center" width="140"> <a href="https://github.com/shanraisshan/gemini-cli-hooks"><img src="!/gemini-speaking.svg" alt="Gemini CLI Hooks" width="64" height="64"></a><br> <a href="https://github.com/shanraisshan/gemini-cli-hooks"><strong>Gemini CLI<br>Hooks</strong></a> </td> <td align="center" width="140"> <a href="https://github.com/shanraisshan/claude-code-best-practice"><img src="!/claude-jumping.svg" alt="Claude Code Best Practice" width="64" height="64"></a><br> <a href="https://github.com/shanraisshan/claude-code-best-practice"><strong>Claude Code<br>Best Practice</strong></a> </td> <td align="center" width="140"> <a href="https://github.com/shanraisshan/codex-cli-best-practice"><img src="!/codex-jumping.svg" alt="Codex CLI Best Practice" width="64" height="64"></a><br> <a href="https://github.com/shanraisshan/codex-cli-best-practice"><strong>Codex CLI<br>Best Practice</strong></a> </td> <td align="center" width="140"> <a href="https://github.com/shanraisshan/gemini-cli-best-practice"><img src="!/gemini-jumping.svg" alt="Gemini CLI Best Practice" width="64" height="64"></a><br> <a href="https://github.com/shanraisshan/gemini-cli-best-practice"><strong>Gemini CLI<br>Best Practice</strong></a> </td> </tr> </table>

Developed by

Workflow	Description
/workflows:workflow-changelog	Scan for new hooks and drift across all files
/workflows:workflow-add-hook <HookName>*	Add any recommended hook across all files in one command

<p align="center"> <img src="!/claude-jumping.svg" alt="section divider" width="60" height="50"> </p>

<img src="!/tags/sponsor-heart.svg" width="22" height="22" align="center"> Sponsor My Work

If you like my work, buy me a doodh patti 🍵 on

<a href="https://buy.polar.sh/polar_cl_cIMlrzYRInDIRBSWU9kSsxaTbiAQm3AVayOot4DIrt8"><img src="!/tags/polar.svg" alt="Polar" width="40" height="40" align="center"></a> <a href="https://buy.polar.sh/polar_cl_cIMlrzYRInDIRBSWU9kSsxaTbiAQm3AVayOot4DIrt8"><strong>Polar</strong></a>