Windows Hook Debugging Skill

SkillFiles & storage

Lets your agent diagnose and fix Claude Code plugin hook errors on Windows, like binary execution and WSL conflicts.

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Windows Hook Debugging Skill skill

About this skill

Diagnosing and fixing Claude Code plugin hook execution errors on Windows. Use when encountering hook error, cannot execute binary file, .sh regex mismatches, or WSL/Git Bash conflicts.

What this skill tells your AI

The instructions your AI receives, as published by foryourhealth111-pixel/vibe-skills in bundled/skills/windows-hook-debugging/SKILL.md and read by ahel’s review.

诊断和修复 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 内容

Signals

GitHub stars
4k
Forks
308
Last commit
Aug 2026
Advanced
Item type
skill
Key
windows-hook-debugging
Source
github.com/foryourhealth111-pixel/vibe-skills