Answer: A hook is skipped when it threw, exceeded its time limit, or returned a result of the wrong shape; a mod is unloaded when it crashed the hooks worker, or all non-built-in mods are unloaded when the worker crashed 3 times and the stops couldn't be traced to one mod. Status: Confirmed Entry: tool/claude-code/troubleshooting/hook-skipped-mod-unloaded Revision: 4 Digest: sha256:e69f81a80ada98fb (changes whenever the content changes) Timeline: Created: 2026-11-13T03:05:20Z Last changed: 2026-11-19T12:19:19Z (hook skipped line format: — → first-mod: tool.call hook skipped: threw Error: boom) Last verified: 2026-11-20T12:23:57Z Next check: 2026-11-21T12:23:57Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of mod unloaded reason | it crashed the hooks worker | [1] | 2026-11-20 worker crash count | 3 times | [1] | 2026-11-20 hook skipped line format | first-mod: tool.call hook skipped: threw Error: boom | [1] | 2026-11-20 Sources: [1] Anthropic. "Troubleshoot a mod". https://code.claude.com/docs/en/plugins/mods/troubleshoot.md Role: primary. Accessed: 2026-11-20T12:23:57Z Quote: "first-mod was unloaded: it crashed the hooks worker" (Supports: mod unloaded reason) Quote: "hooks: mods that run in the hooks worker are off for this session: it crashed 3 times" (Supports: worker crash count) Quote: "first-mod: tool.call hook skipped: threw Error: boom" (Supports: hook skipped line format) Published: 2026-11-20T03:00:59Z Snapshot SHA-256: 782ac923e4f73ee0bdb3a5512852310618c2666d6655dc230d953b5a543c12a4 (captured 2026-11-19T12:19:18Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-19T12:19:19Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T12:23:57Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:23:57Z Last attempt: 2026-11-20T12:23:57Z Notes and limitations: Extracted automatically from a single official source (section "A hook is skipped or a mod is unloaded"). Related: https://latestn.com/tool/claude-code/troubleshooting/hooks-module-not-loaded What does the Claude Code refusal message "hooks module not loaded" mean when running claude -p? https://latestn.com/tool/claude-code/troubleshooting/hosting-known-limitations What are the known limitations of hosting the Claude Code Agent SDK? https://latestn.com/tool/claude-code/troubleshooting/list-loaded-mods How can I see which mods a Claude Code session loaded? https://latestn.com/tool/claude-code/troubleshooting/gitlab-claude-not-responding How do I troubleshoot Claude Code not responding to @claude commands in GitLab? https://latestn.com/tool/claude-code/troubleshooting/handle-cut-off-stream How do I handle a stream that gets cut off in the Claude Code Agent SDK? https://latestn.com/tool/claude-code/troubleshooting/hook-not-firing How do I fix a hook that is not firing in Claude Code? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-19T12:19:19Z | changed | hook skipped line format: — → first-mod: tool.call hook skipped: threw Error: boom | [1] 2026-11-19T12:19:19Z | changed | worker crash count: — → 3 times | [1] 2026-11-19T12:19:19Z | changed | hooks worker off line: it crashed 3 times → — | [1] 2026-11-19T12:19:19Z | changed | worker crash cause: A hook that blocks the thread, such as a loop that never awaits, is one cause. → — | [1] 2026-11-18T12:19:10Z | changed | hooks worker off line: — → it crashed 3 times | [1] 2026-11-18T12:19:10Z | changed | worker crash cause: — → A hook that blocks the thread, such as a loop that never awaits, is one cause. | [1] 2026-11-18T12:19:10Z | changed | version before which call ran twice: v2.1.292 → — | [1] 2026-11-18T12:19:10Z | changed | hook skipped line format: hook skipped: → — | [1] 2026-11-18T12:19:10Z | changed | worker crash count: it crashed 3 times → — | [1] 2026-11-18T12:19:10Z | changed | hook skipped reasons: A hook threw, exceeded its [time limit](https://code.claude.com/docs/en/plugins/mods/reference.md#limits), or returned a result of the wrong shape. → — | [1] 2026-11-16T12:11:36Z | changed | version before which call ran twice: — → v2.1.292 | [1] 2026-11-16T12:11:36Z | changed | hook skipped line format: — → hook skipped: | [1] 2026-11-16T12:11:36Z | changed | mod unloaded reason: — → it crashed the hooks worker | [1] 2026-11-16T12:11:36Z | changed | hook skipped reasons: — → A hook threw, exceeded its [time limit](https://code.claude.com/docs/en/plugins/mods/reference.md#limits), or returned a result of the wrong shape. | [1] 2026-11-16T12:11:36Z | changed | reload command: /reload-plugins → — | [1] 2026-11-16T12:11:36Z | changed | worker crash count: 3 times → it crashed 3 times | [1] 2026-11-16T12:11:36Z | changed | unload cause: it crashed the hooks worker → — | [1] 2026-11-13T03:05:20Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-code/troubleshooting/hook-skipped-mod-unloaded/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/claude-code/troubleshooting/hook-skipped-mod-unloaded POST: https://latestn.com/dispute/tool/claude-code/troubleshooting/hook-skipped-mod-unloaded with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-code/troubleshooting/hook-skipped-mod-unloaded?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). Why is a Claude Code hook skipped or a mod unloaded? Revision 4, last verified 2026-11-20T12:23:57Z. https://latestn.com/tool/claude-code/troubleshooting/hook-skipped-mod-unloaded (accessed 2026-11-21T09:59:03Z). @misc{LatestN_tool_claude_code_troubleshooting_hook_skipped_mod_unloaded_r4, title = {Why is a Claude Code hook skipped or a mod unloaded?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-code/troubleshooting/hook-skipped-mod-unloaded}}, note = {Revision 4; digest sha256:e69f81a80ada98fb; last verified 2026-11-20T12:23:57Z; accessed 2026-11-21T09:59:03Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/claude-code/troubleshooting/hook-skipped-mod-unloaded