ITP Hooks Manager
Manage itp-hooks installation in ~/.claude/settings.json.
Claude Code only loads hooks from settings.json, not from plugin.json files. This command installs/uninstalls three itp-hooks:
- PreToolUse guard - Blocks ASCII diagrams without graph-easy source blocks
- PostToolUse reminder - Prompts ADR/spec sync after file modifications
- Fake-data-guard - Detects fake/synthetic data patterns (np.random, Faker, etc.) in new Python files
Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.
Actions
| Action | Description |
|---|---|
status | Show current installation state |
install | Add itp-hooks to settings.json |
uninstall | Remove itp-hooks from settings.json |
restore | List available backups with numbers |
restore latest | Restore most recent backup |
restore <n> | Restore backup by number |
Execution
Parse $ARGUMENTS and run the management script:
/usr/bin/env bash << 'HOOKS_SCRIPT_EOF'
PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/itp}"
ACTION="${ARGUMENTS:-status}"
bash "$PLUGIN_DIR/scripts/manage-hooks.sh" $ACTION
HOOKS_SCRIPT_EOFPost-Action Reminder
After install/uninstall/restore operations:
IMPORTANT: Restart Claude Code session for changes to take effect.
The hooks are loaded at session start. Modifications to settings.json require a restart.
Examples
# Check current installation status
/itp:hooks status
# Install all itp-hooks
/itp:hooks install
# Uninstall hooks
/itp:hooks uninstall
# List available backups
/itp:hooks restore
# Restore most recent backup
/itp:hooks restore latestTroubleshooting
| Issue | Cause | Solution |
|---|---|---|
| jq not found | jq not installed | brew install jq |
| bun not found | bun/node not installed | mise install bun |
| Already installed | Hook already in settings | Run uninstall first to reinstall |
| Hooks not working | Session not restarted | Restart Claude Code session |
| Script not found | Plugin not installed | Re-install plugin via marketplace |
| Invalid JSON | Corrupted settings.json | Use restore latest to recover |
Post-Execution Reflection
After this skill completes, check before closing:
- Did the command succeed? — If not, fix the instruction or error table that caused the failure.
- Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
- Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.
Only update if the issue is real and reproducible — not speculative.