Skip to content

Skills, Agents, Hooks

Validates skill/agent frontmatter and hook configuration. The security rules scan hooks in hooks.json, .claude/settings*.json, and skill/agent frontmatter (hooks: key) for supply-chain attack patterns (inspired by the Shai-Hulud attack).

Rule ID Description Default Severity Autofix
skill-frontmatter SKILL.md files should have frontmatter with name and description warning auto
agent-frontmatter Agent files must have valid frontmatter with name and description error auto
hooks-json-valid hooks.json must be valid JSON with proper hook configuration structure error -
hooks-dangerous Flags hook commands that execute scripts from dotfile directories, download-and-execute chains (curl|sh), obfuscation (eval/base64), or perform network requests error (auto) -
hooks-prohibited All hook commands are prohibited unless explicitly allowlisted; catches new or unexpected hooks added to a project error (disabled) -