What problem does it solve? Misconfigured hooks.json files cause silent failures and runtime errors in Claude Code plugins, especially when prompt or agent hooks are registered on events that lack ToolUseContext. This Skill audits hooks.json and reports every structural and compatibility issue with severity levels and remediation guidance. ## Core Features & Use Cases - Type-Event Compatibility Check: Cross-references all 4 hook types (command, http, prompt, agent) against all 22 events, flagging prompt/agent hooks on the 19 non-ToolUseContext events as CRITICAL. - Structural Validation: Verifies JSON syntax, the top-level hooks object shape, valid event names with misspelling suggestions, required fields per hook type, and matcher values. - Script Reference Checks: Confirms that command-type hooks point to existing, executable script files within the plugin tree. - Use Case: Before publishing a plugin, run this audit to catch a prompt hook mistakenly registered on SessionStart, which would otherwise fail silently at runtime. ## Quick Start Validate the hooks.json file in my plugin at ./my-plugin and report any type-event compatibility problems.
