install-toolkit

Available components:

• Skills (12): git, pytest-best-practices, sqlalchemy-postgres, debug-like-expert, create-plans, spec-interview, manage-subagents, manage-hooks, manage-slash-commands, manage-skills, create-meta-prompts, damage-control
• Agents (7): git-ops, db-expert, pytest-writer, fullstack-manager, fullstack-api-specialist, fullstack-ui-designer, fullstack-qa-debugger
• Commands (6): commit, push, pr, ship, db, spec-interview
• Hooks: hooks.json + hook scripts
• Damage Control: Security hooks that block dangerous commands (rm -rf, git reset --hard, etc.) and protect sensitive files (.env, ~/.ssh/, credentials)
• Extras: statusline.sh, settings.json

1. Check dependencies: Run bash commands to check for jq, git, and platform-specific tools (tac/gtac)

   • Report status to user
   • If missing, ask if they want to install them

2. Check Claude Code CLI:

   • If installed: show version, offer to check for updates
   • If not installed, offer to install:
     • macOS: brew install --cask claude-code (preferred)
     • Linux: npm install -g @anthropic-ai/claude-code@latest
   • If package manager not available: show manual install instructions

3. Ask installation mode using AskUserQuestion:

   • "Install All" - Copy everything (recommended)
   • "Select by Category" - Choose which folders to install
   • "Custom Selection" - Pick individual items

4. If "Select by Category", ask for each category:

   • Skills: All / Skip
   • Agents: All / Skip
   • Commands: All / Skip
   • Hooks: All / Skip
   • Damage Control: Yes / No (security hooks)
   • Statusline: Yes / No
   • Settings: Merge / Skip

5. If "Custom Selection", for each category ask which specific items to install

6. Execute installation:

   # Create directories
   mkdir -p ~/.claude/{skills,agents,commands,hooks}
   
   # Copy selected skills (replace existing)
   rm -rf ~/.claude/skills/SKILL_NAME && cp -r TOOLKIT/skills/SKILL_NAME ~/.claude/skills/
   
   # Copy selected agents
   cp TOOLKIT/agents/AGENT.md ~/.claude/agents/
   
   # Copy selected commands
   cp TOOLKIT/commands/COMMAND.md ~/.claude/commands/
   
   # Copy hooks (backup existing)
   cp ~/.claude/hooks.json ~/.claude/hooks.json.bak 2>/dev/null
   cp TOOLKIT/hooks.json ~/.claude/hooks.json
   
   # Copy statusline
   cp TOOLKIT/statusline.sh ~/.claude/statusline.sh && chmod +x ~/.claude/statusline.sh
   
   # Merge settings (if jq available)
   cp ~/.claude/settings.json ~/.claude/settings.json.bak 2>/dev/null
   jq -s '.[1] * .[0]' TOOLKIT/settings.json ~/.claude/settings.json > /tmp/merged.json && mv /tmp/merged.json ~/.claude/settings.json
   

7. Install Damage Control (if selected):

   • Check for UV runtime: which uv
   • If UV not found, offer to install: curl -LsSf https://astral.sh/uv/install.sh | sh
   • Create hooks directory: mkdir -p ~/.claude/hooks/damage-control
   • Copy Python scripts: cp TOOLKIT/skills/damage-control/scripts/*.py ~/.claude/hooks/damage-control/
   • Copy patterns.yaml: cp TOOLKIT/skills/damage-control/scripts/patterns.yaml ~/.claude/hooks/damage-control/
   • Make executable: chmod +x ~/.claude/hooks/damage-control/*.py
   • Merge settings with damage-control hooks and permissions:

     # Backup existing
     cp ~/.claude/settings.json ~/.claude/settings.json.bak 2>/dev/null
     # Merge hooks and permissions
     jq -s '
       def merge_hooks: (.[0].hooks.PreToolUse // []) + (.[1].hooks.PreToolUse // []) | unique_by(.matcher);
       def merge_permissions: {
         deny: ((.[0].permissions.deny // []) + (.[1].permissions.deny // []) | unique),
         ask: ((.[0].permissions.ask // []) + (.[1].permissions.ask // []) | unique)
       };
       .[0] * .[1] | .hooks.PreToolUse = (.[0] | merge_hooks) | .permissions = ([.[0], .[1]] | merge_permissions)
     ' ~/.claude/settings.json TOOLKIT/skills/damage-control/scripts/settings-template.json > /tmp/merged.json && mv /tmp/merged.json ~/.claude/settings.json
     

   • Verify files exist:
     • ~/.claude/hooks/damage-control/bash-tool-damage-control.py
     • ~/.claude/hooks/damage-control/edit-tool-damage-control.py
     • ~/.claude/hooks/damage-control/write-tool-damage-control.py
     • ~/.claude/hooks/damage-control/patterns.yaml
   • IMPORTANT: Remind user to restart Claude Code for hooks to take effect
   • Tell user to run /hooks after restart to verify registration