| name | tether |
| description | Tether (install/uninstall) itp-hooks (ASCII guard, ADR sync reminder, fake-data-guard) to ~/.claude/settings.json. Renamed from. |
| allowed-tools | Read, Bash, TodoWrite, TodoRead |
| argument-hint | [install|uninstall|status|restore [latest|<n>]] |
| model | haiku |
| disable-model-invocation | true |
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="$(cc-plugin-root itp)"
ACTION="${ARGUMENTS:-status}"
bash "$PLUGIN_DIR/scripts/manage-hooks.sh" $ACTION
HOOKS_SCRIPT_EOF
Post-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
/itp:tether status
/itp:tether install
/itp:tether uninstall
/itp:tether restore
/itp:tether restore latest
Troubleshooting
| 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.
