Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/shanraisshan/claude-code-hooks/claude-mdgit clone --depth 1 https://github.com/shanraisshan/claude-code-hooksWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/shanraisshan/claude-code-hooks/claude-md)<a href="https://agentmods.dev/instructions/shanraisshan/claude-code-hooks/claude-md"><img src="https://agentmods.dev/badge/instructions/shanraisshan/claude-code-hooks/claude-md.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00898 | $0.00898 |
| Opus 5 | $0.00449 | $0.00449 |
| Sonnet 5 | $0.00180 | $0.00180 |
| Haiku 4.5 | $0.00090 | $0.00090 |
Grade B, and why
claude-code-hooks CLAUDE.md scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Reads agent configuration directoriesmediumAgent snooping
.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.
- `demo/.claude/settings.json` hook entries How it starts
The opening of the file, as written. The whole thing — 86 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Claude Code Hooks
Sound notification system for all 30 Claude Code hooks. Plays sound effects when hook events fire.
Project Structure
.claude/
settings.json
hooks/
scripts/hooks.py
config/hooks-config.json
sounds/<hookname>/
HOOKS-README.md
agents/
workflows/workflow-changelog-agent.md
claude-code-test-agent.md
commands/workflows/
workflow-changelog.md
workflow-add-hook.md
install/
settings-mac.json
settings-linux.json
settings-windows.json
presentation/index.html
changelog/
changelog.md
verification-checklist.md
Critical: Hook Count Consistency
The hook count (currently 30) MUST match across ALL of these locations:
.claude/settings.jsonhook entriesinstall/settings-mac.json,settings-linux.json,settings-windows.jsonhooks.pyHOOK_SOUND_MAP keys + docstring counthooks-config.jsontoggle countHOOKS-README.mdheading + numbered listREADME.mdbadge + changelog tablepresentation/index.html(slides 2, 3, TOC, totalSlides)claude-code-test-agent.mdfrontmatter + bodydemo/.claude/settings.jsonhook entriesdemo/.claude/hooks/scripts/demo-hooks.pyHOOK_SOUND_MAP + docstringdemo/hooks-lifecycle.htmlflowchart SVG + prompt cards + branding count
When adding a hook, use /workflows:workflow-add-hook — it updates all 14 files.
Agent Hooks
Only 6 of 30 hooks fire in agent sessions: PreToolUse, PostToolUse, PermissionRequest, PostToolUseFailure, Stop, SubagentStop. These are mapped in AGENT_HOOK_SOUND_MAP in hooks.py.
Workflows
/workflows:workflow-changelog [N]— Check last N versions for drift. Launches 2 agents in parallel, runs verification checklist, appends to changelog.md/workflows:workflow-add-hook <HookName>— Add a new hook across all files (sounds, config, settings, scripts, docs, presentation)/commit— Auto-generate commit message with timestamp and change count
Conventions
- Hook names are PascalCase everywhere (e.g.
PreToolUse,InstructionsLoaded) - Sound folder names are lowercase (e.g.
pretooluse,instructionsloaded) - Settings files: timeout 5000 for all hooks except Setup (30000)
once: trueonly on: PreCompact, SessionStart, SessionEndasync: trueon all hooks- Changelog entries use PKT timezone:
TZ=Asia/Karachi date - Version badge format:
v2.X.X | Mon DD, YYYY HH:MM AM/PM PKT
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 6d ago First seen · 86 lines · 898 tokens per session scan B 749198bf0ca5
claude-code-hooks CLAUDE.md is an instructions file published in the GitHub repository shanraisshan/claude-code-hooks (536 stars, last pushed 3mo ago), licensed MIT. It adds 898 tokens to every session, about $0.0045 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
codex-cli-best-practice AGENTS.md
Instructions for shanraisshan/codex-cli-best-practice, covering agents.md, what this is, architecture, orchestration flow and key directories.
codex-cli-hooks CLAUDE.md
Claude Code instructions for shanraisshan/codex-cli-hooks, covering claude.md / agents.md, what this repo is, common commands, run a single test and manually invoke a hook (what codex does internally).
codex-cli-hooks AGENTS.md
AGENTS.md instructions for shanraisshan/codex-cli-hooks, a project described as: codex cli hooks - adding voice on each hook.
codex-cli-best-practice CLAUDE.md
Instructions for shanraisshan/codex-cli-best-practice, covering claude.md, what this is, architecture, orchestration flow and key directories.
moai-adk CLAUDE.md
Claude Code instructions for modu-ai/moai-adk, covering moai execution directive, 0. standing contract (imported), 1. core identity, hard rules (mandatory) and 2. request processing pipeline.
shanraisshan CLAUDE.md
Claude Code instructions for shanraisshan/shanraisshan, covering claude.md, what this repo is, key files, badge formatting rules and reddit views (badges at >= 50k).