When To Use
- Browsing available hookify rules by category
- Installing standard pre-built rules into a project
- Looking for ready-made rules before writing custom ones
When NOT To Use
- Writing custom rules from scratch: use
hookify:writing-rules instead
- Debugging or modifying existing installed rules
- Converting Python SDK hooks: use
hookify:from-hook instead
Table of Contents
Hookify Rule Catalog
Pre-built rules for common scenarios. Install directly or use as templates.
Quick Install
Skill(hookify:rule-catalog) then install git:block-force-push
python3 plugins/hookify/scripts/install_rule.py git:block-force-push
python3 plugins/hookify/scripts/install_rule.py --category git
python3 plugins/hookify/scripts/install_rule.py --all
Verification: Run python --version to verify Python environment.
Available Rules
git/ - Git Safety
| Rule | Action | Default | Description |
|---|
block-force-push | block | enabled | Prevent force push to main/master |
block-destructive-git | block | enabled | Block reset --hard, checkout -- ., clean -fd, etc. |
warn-risky-git | warn | enabled | Warn about rebase -i, soft reset, etc. |
warn-large-commits | warn | enabled | Warn about large binary files |
python/ - Python Quality
| Rule | Action | Default | Description |
|---|
block-dynamic-code | block | enabled | Block dangerous dynamic code execution |
warn-print-statements | warn | enabled | Encourage logging over print() |
security/ - Security Gates
| Rule | Action | Default | Description |
|---|
require-security-review | block | enabled | Require review for auth code |
destructive-command-guard | warn | enabled | Warn on destructive commands targeting prod-shaped paths |
workflow/ - Workflow Enforcement
| Rule | Action | Default | Description |
|---|
enforce-scope-guard | warn | enabled | Anti-overengineering (imbue) |
require-spec-before-code | block | disabled | Spec-first development |
performance/ - Resource Management
| Rule | Action | Default | Description |
|---|
warn-large-file-ops | warn | enabled | Watch large file writes |
Installation Instructions
Method 1: Claude-Assisted (Recommended)
When you invoke this skill, tell Claude which rule(s) to install:
**Verification:** Run `git status` to confirm working tree state.
Install git:block-force-push
Verification: Run the command with --help flag to verify availability.
Claude will:
- Read the rule from
skills/rule-catalog/rules/git/block-force-push.md
- Write it to
.claude/hookify.block-force-push.local.md
- Confirm installation
Method 2: Python Script
For bulk operations or automation:
python3 plugins/hookify/scripts/install_rule.py git:block-force-push
python3 plugins/hookify/scripts/install_rule.py --category python
python3 plugins/hookify/scripts/install_rule.py --all
python3 plugins/hookify/scripts/install_rule.py --list
python3 plugins/hookify/scripts/install_rule.py git:block-force-push --target /path/to/.claude
Verification: Run the command with --help flag to verify availability.
Method 3: Manual Copy
- Find rule in
plugins/hookify/skills/rule-catalog/rules/<category>/<rule>.md
- Copy to
.claude/hookify.<rule-name>.local.md
- Edit
enabled: true/false as needed
Rule File Locations
Rules are stored relative to this skill:
**Verification:** Run the command with `--help` flag to verify availability.
skills/rule-catalog/
โโโ SKILL.md (this file)
โโโ rules/
โโโ git/
โ โโโ block-force-push.md
โ โโโ block-destructive-git.md
โ โโโ warn-risky-git.md
โ โโโ warn-large-commits.md
โโโ python/
โ โโโ block-dynamic-code.md
โ โโโ warn-print-statements.md
โโโ security/
โ โโโ require-security-review.md
โ โโโ destructive-command-guard.md
โโโ workflow/
โ โโโ enforce-scope-guard.md
โ โโโ require-spec-before-code.md
โโโ performance/
โโโ warn-large-file-ops.md
Verification: Run the command with --help flag to verify availability.
Customizing Rules
After installation, edit the rule in .claude/:
action: block
enabled: false
pattern: your-custom-pattern
Verification: Run the command with --help flag to verify availability.
Creating Pull Requests for New Rules
To add rules to the catalog:
- Create rule file in appropriate category
- Follow naming convention:
kebab-case.md
- Include detailed message with alternatives
- Test thoroughly before submitting
- Update this SKILL.md catalog table
Related
Skill(hookify:writing-rules) - Create custom rules/hookify:list - Show installed rules/hookify:configure - Manage installed rules
Exit Criteria
