Setup

Prerequisite — cc-plugin-root. This skill resolves its scripts with cc-plugin-root <plugin> (the CLAUDE_PLUGIN_ROOT placeholder is not a shell variable and expands to empty). If the command is missing, run /itp:setup (its first step installs it), or link it directly:

mkdir -p ~/.local/bin && ln -sfn \
  ~/.claude/plugins/marketplaces/cc-skills/scripts/cc-plugin-root ~/.local/bin/cc-plugin-root

ITP Hooks Setup

Verify and install dependencies for the itp-hooks plugin:

• jq (required) - JSON processing for hook input/output
• bun or node (required) - Runtime for fake-data-guard.mjs hook
• ruff (optional) - Python silent failure detection
• shellcheck (optional) - Shell script analysis
• oxlint (optional) - JavaScript/TypeScript linting

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.

Quick Start

Run dependency check:

/usr/bin/env bash << 'SETUP_EOF'
PLUGIN_DIR="$(cc-plugin-root itp-hooks)"
bash "$PLUGIN_DIR/scripts/install-dependencies.sh" --check
SETUP_EOF

Interactive Setup Workflow

Step 1: Check Dependencies

/usr/bin/env bash << 'CHECK_EOF'
PLUGIN_DIR="$(cc-plugin-root itp-hooks)"
bash "$PLUGIN_DIR/scripts/install-dependencies.sh" --check
CHECK_EOF

Step 2: Present Findings

After running the check, present the findings to the user:

Step 3: User Decision (if missing tools)

If optional linters are missing, use AskUserQuestion:

question: "Install optional linters for full silent failure detection coverage?"
header: "Linters"
options:
  - label: "Install all"
    description: "Install ruff, shellcheck, and oxlint for Python, Shell, and JS/TS coverage"
  - label: "Skip"
    description: "Continue with graceful degradation (detection only for installed linters)"

Step 4: Install (if confirmed)

/usr/bin/env bash << 'INSTALL_EOF'
PLUGIN_DIR="$(cc-plugin-root itp-hooks)"
bash "$PLUGIN_DIR/scripts/install-dependencies.sh" --install
INSTALL_EOF

Flags

Graceful Degradation

The hooks work with graceful degradation:

Next Steps

No hook installation step exists. hooks/hooks.json in this plugin is what Claude Code loads, so enabling the plugin is the installation. The /itp:tether install path was retired in issue #127 — injecting the same hooks into ~/.claude/settings.json double-registered them, and its script had been inert since posttooluse-reminder.sh became posttooluse-reminder.ts.

IMPORTANT: Restart the Claude Code session for newly enabled plugin hooks to take effect.

Troubleshooting

Post-Execution Reflection

After this skill completes, reflect before closing the task:

0. Locate yourself. — Find this SKILL.md's canonical path before editing.
1. What failed? — Fix the instruction that caused it.
2. What worked better than expected? — Promote to recommended practice.
3. What drifted? — Fix any script, reference, or dependency that no longer matches reality.
4. Log it. — Evolution-log entry with trigger, fix, and evidence.

Do NOT defer. The next invocation inherits whatever you leave behind.