# Windows Hook Debugging

> Windows Hook Debugging is an Agent Skill for testing & quality published in the foryourhealth111-pixel/Vibe-Skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Windows环境下Claude Code插件Hook执行错误的诊断与修复。当遇到hook error、cannot execute binary file、.sh regex误匹配、WSL/Git Bash冲突时使用。

- Skill name: `windows-hook-debugging`
- Category: [Testing & Quality](https://www.openparable.com/skill/testing-quality/1)
- Source: https://github.com/foryourhealth111-pixel/Vibe-Skills/blob/HEAD/bundled/skills/windows-hook-debugging/SKILL.md
- Repository: foryourhealth111-pixel/Vibe-Skills (2,381 GitHub stars when collected)

## SKILL.md

# Windows Hook Debugging Skill

诊断和修复 Windows 环境下 Claude Code 插件 Hook 执行失败的问题。

## When to Use This Skill

触发条件（满足任一即可）：
- Claude Code 启动时出现 `SessionStart hook error` 或 `Stop hook error`
- 错误信息包含 `cannot execute binary file`
- 错误信息包含 `/d/` 或 `/c/` 风格的路径（MSYS2/Git Bash 路径格式）
- 错误信息包含 `bash: node: No such file or directory`
- 错误信息包含 WSL 相关乱码或 `wsl:` 前缀
- Hook 命令中包含 `.sh` 参数导致 Windows 下被错误处理

## Not For / Boundaries

- 不适用于 macOS/Linux 上的 hook 问题（那些平台没有 WSL/Git Bash 冲突）
- 不适用于 hook 逻辑错误（如 JSON 解析失败、权限拒绝等业务逻辑问题）
- 不适用于 MCP Server 连接问题
- 需要的输入：完整的错误信息、当前 settings.json 内容、相关 hooks.json 内容

---

Source: https://www.openparable.com/skill/testing-quality/windows-hook-debugging (OpenParable). Cite the canonical URL above.
