RU: Hooks

Manage RU hooks in ~/.claude/settings.json.

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.

Usage

/ru:hooks install   # Add hooks to settings.json
/ru:hooks uninstall # Remove hooks from settings.json
/ru:hooks status    # Show current hook status

Important

After installing hooks, you MUST restart Claude Code for them to take effect.

Execution

/usr/bin/env bash << 'RALPH_UNIVERSAL_HOOKS'
SETTINGS="$HOME/.claude/settings.json"
COMMAND="${ARGUMENTS:-status}"
MARKER="ru/hooks/"

# Ensure settings.json exists
if [[ ! -f "$SETTINGS" ]]; then
    echo '{}' > "$SETTINGS"
fi

case "$COMMAND" in
    install)
        echo "Installing RU hooks..."

        # Record installation timestamp
        date +%s > "$HOME/.claude/ru-hooks-installed-at"

        # Check if already installed
        if grep -q "$MARKER" "$SETTINGS" 2>/dev/null; then
            echo "Hooks already installed."
            echo ""
            echo "IMPORTANT: Restart Claude Code if you haven't already."
            exit 0
        fi

        echo ""
        echo "Hooks will be registered when you run:"
        echo "  /plugin install ru@cc-skills"
        echo ""
        echo "Then restart Claude Code for hooks to take effect."
        ;;

    uninstall)
        echo "Uninstalling RU hooks..."

        # Remove timestamp
        rm -f "$HOME/.claude/ru-hooks-installed-at"

        echo "Hooks will be removed when you run:"
        echo "  /plugin uninstall ru@cc-skills"
        echo ""
        echo "Restart Claude Code after uninstalling."
        ;;

    status)
        echo "RU Hooks Status"
        echo "============================"
        echo ""

        if grep -q "$MARKER" "$SETTINGS" 2>/dev/null; then
            echo "Status: INSTALLED"
            HOOK_COUNT=$(grep -o "$MARKER" "$SETTINGS" | wc -l | tr -d ' ')
            echo "Hooks: $HOOK_COUNT registered"
        else
            echo "Status: NOT INSTALLED"
            echo ""
            echo "Run: /ru:hooks install"
        fi

        if [[ -f "$HOME/.claude/ru-hooks-installed-at" ]]; then
            INSTALL_TS=$(cat "$HOME/.claude/ru-hooks-installed-at")
            INSTALL_DATE=$(date -r "$INSTALL_TS" '+%Y-%m-%d %H:%M:%S' 2>/dev/null || echo "unknown")
            echo "Installed at: $INSTALL_DATE"
        fi
        ;;

    *)
        echo "Usage: /ru:hooks [install|uninstall|status]"
        exit 1
        ;;
esac
RALPH_UNIVERSAL_HOOKS

Examples

# Check current hook status
/ru:hooks status

# Install RU hooks
/ru:hooks install

# Uninstall hooks
/ru:hooks uninstall

Troubleshooting

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.