Table of Contents
- •Quick Install
- •Available Rules
- •git/ - Git Safety
- •python/ - Python Quality
- •security/ - Security Gates
- •workflow/ - Workflow Enforcement
- •performance/ - Resource Management
- •Installation Instructions
- •Method 1: Claude-Assisted (Recommended)
- •Method 2: Python Script
- •Method 3: Manual Copy
- •Rule File Locations
- •Customizing Rules
- •Creating Pull Requests for New Rules
- •Related
Hookify Rule Catalog
Pre-built rules for common scenarios. Install directly or use as templates.
Quick Install
bash
# Install a specific rule Skill(hookify:rule-catalog) then install git:block-force-push # Or use the Python installer for bulk operations 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 |
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:
code
**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:
bash
# Install single rule python3 plugins/hookify/scripts/install_rule.py git:block-force-push # Install all rules in category python3 plugins/hookify/scripts/install_rule.py --category python # Install all rules python3 plugins/hookify/scripts/install_rule.py --all # List available rules python3 plugins/hookify/scripts/install_rule.py --list # Install to custom directory 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/falseas needed
Rule File Locations
Rules are stored relative to this skill:
code
**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
├── 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/:
yaml
# Change action from warn to block action: block # Disable temporarily enabled: false # Modify pattern 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
Troubleshooting
Common Issues
Command not found Ensure all dependencies are installed and in PATH
Permission errors Check file permissions and run with appropriate privileges
Unexpected behavior
Enable verbose logging with --verbose flag