Cc-skills setup
Check and install dependencies for itp-hooks (silent failure detection + fake-data-guard). TRIGGERS - itp-hooks setup, install hook deps, hook dependencies, ruff install.
git clone https://github.com/terrylica/cc-skills
T=$(mktemp -d) && git clone --depth=1 https://github.com/terrylica/cc-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/itp-hooks/skills/setup" ~/.claude/skills/terrylica-cc-skills-setup-f41702 && rm -rf "$T"
plugins/itp-hooks/skills/setup/SKILL.mdITP 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="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/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="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/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:
| Tool | Status | Purpose |
|---|---|---|
| jq | ? | Required for hook I/O |
| bun/node | ? | Required for fake-data-guard |
| ruff | ? | Python silent failure rules |
| shellcheck | ? | Shell script analysis |
| oxlint | ? | JavaScript/TypeScript linting |
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="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/itp-hooks}" bash "$PLUGIN_DIR/scripts/install-dependencies.sh" --install INSTALL_EOF
Flags
| Flag | Behavior |
|---|---|
| (none) | Check dependencies, show status |
| Same as default |
| Check then install all missing tools |
Graceful Degradation
The hooks work with graceful degradation:
| Tool Missing | Effect |
|---|---|
| bun/node | Fake-data-guard hook fails |
| ruff | Python files skip silent failure check |
| shellcheck | Shell scripts skip analysis |
| oxlint | JS/TS files skip linting |
| jq | All hooks fail (required for JSON I/O) |
Next Steps
After setup, install the hooks to your settings:
/itp:hooks install
IMPORTANT: Restart Claude Code session for hooks to take effect.
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| jq not found | jq not installed | |
| bun/node not found | Runtime not installed | |
| mise not installed | Missing tool manager | Install from https://mise.jdx.dev |
| ruff version error | Outdated ruff | |
| Plugin dir not found | Plugin not installed | Re-install plugin via marketplace |
| PATH issues | Shims not in PATH | Add mise shims to ~/.zshenv |
Post-Execution Reflection
After this skill completes, reflect before closing the task:
- Locate yourself. — Find this SKILL.md's canonical path before editing.
- What failed? — Fix the instruction that caused it.
- What worked better than expected? — Promote to recommended practice.
- What drifted? — Fix any script, reference, or dependency that no longer matches reality.
- Log it. — Evolution-log entry with trigger, fix, and evidence.
Do NOT defer. The next invocation inherits whatever you leave behind.