writing-hookify-rules

The writing-hookify-rules skill helps users create, configure, and understand Hookify rule files used to monitor actions and trigger guidance messages based on matching patterns. It provides structured guidance for building markdown-based rule definitions with YAML frontmatter, allowing users to define events, matching logic, and response behavior in a consistent format. The skill is designed to reduce configuration errors and simplify the process of writing rule-based safeguards and workflow checks for command execution, file edits, prompt handling, and session stop events.

The skill covers both simple and advanced Hookify rule formats. It explains required frontmatter fields such as name, enabled, event, and pattern, along with optional actions like warn and block. It also documents advanced condition-based matching using multiple fields and operators including regex matching, substring checks, equality validation, and prefix or suffix detection. Additional guidance is provided for crafting effective markdown message bodies that clearly explain detected issues, risks, and recommended alternatives. The documentation includes practical examples for bash command monitoring, file edit validation, environment variable protection, and code quality checks.

This skill is useful for developers, DevOps engineers, security-focused teams, and AI workflow maintainers who need customizable rule-based monitoring within Hookify environments. Common use cases include detecting dangerous shell commands, preventing insecure permission changes, warning about sensitive data exposure, enforcing coding standards, and guiding users during automated workflows. It is particularly valuable for teams that want lightweight policy enforcement and contextual guidance without building complex tooling from scratch.