Cc-skills hooks

Install/uninstall itp-hooks (ASCII guard, ADR sync reminder, fake-data-guard) to ~/.claude/settings.json. TRIGGERS - itp hooks, install itp hooks, itp hook manager, adr sync hook.

install
source · Clone the upstream repo
git clone https://github.com/terrylica/cc-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/terrylica/cc-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/itp/skills/hooks" ~/.claude/skills/terrylica-cc-skills-hooks-2ac774 && rm -rf "$T"
manifest: plugins/itp/skills/hooks/SKILL.md
source content
<!-- ADR: 2025-12-07-itp-hooks-settings-installer -->

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

ActionDescription
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_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

# 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 latest

Troubleshooting

IssueCauseSolution
jq not foundjq not installed
brew install jq
bun not foundbun/node not installed
mise install bun
Already installedHook already in settingsRun
uninstall
first to reinstall
Hooks not workingSession not restartedRestart Claude Code session
Script not foundPlugin not installedRe-install plugin via marketplace
Invalid JSONCorrupted settings.jsonUse
restore latest
to recover

Post-Execution Reflection

After this skill completes, check before closing:

  1. Did the command succeed? — If not, fix the instruction or error table that caused the failure.
  2. Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
  3. 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.