← All skills

diagnosing-hooks

100 / 100 · Low risk

Fine to try.

By zai-org/ZCode (GitHub) · productivity · 8,613 stars · scanned at commit b95ebaf

Use to diagnose and fix ZCode hook configuration problems in the ZCode client. Applies when a hook does not trigger, an event name is wrong, a matcher does not match a tool name, a script is not executable, template variables are not expanded, a timeout unit is mistaken (seconds versus milliseconds), the command and process field styles are mixed, a hook's JSON output fails validation, a hook blocks the session unexpectedly, or configuration-file hooks are not enabled. Provides configuration so…

Works with any agent that supports SKILL.md skills.

What this skill can do

We found nothing in the files we read that matches our rules. That does not prove the skill is safe: see the limits of static scanning.

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'diagnosing-hooks' ] || [ -L ~/.agents/skills/'diagnosing-hooks' ]; then echo 'A skill folder named diagnosing-hooks already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/zai-org/ZCode' "$d" && git -C "$d" checkout --quiet 'b95ebaffeab641907b38652f45c1502bd762972d' -- 'apps/zcode-cli/packages/zcode-guide-plugin/skills/diagnosing-hooks' && mkdir -p ~/.agents/skills && cp -R "$d"/'apps/zcode-cli/packages/zcode-guide-plugin/skills/diagnosing-hooks' ~/.agents/skills/'diagnosing-hooks' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'diagnosing-hooks' ~/.claude/skills/'diagnosing-hooks' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for zai-org/ZCode shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/zai-org/ZCode.svg)](https://zalavijaysinh.github.io/skilltrust/repos/zai-org/ZCode/)

Score history