productivity-tools Hooks Manager

Manage productivity-tools hook installation in ~/.claude/settings.json.

The calendar-reminder-sync hook validates sound alarm compliance on Calendar event creation and auto-creates paired Reminders.

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

Action	Description
status	Check hook installation status and dependencies
install	Add productivity-tools hooks to settings.json
uninstall	Remove productivity-tools hooks from settings.json

What the Hook Does

Trigger	Condition	Action
PostToolUse/Bash	osascript + make new event	Validates sound alarms, auto-creates 3 Reminders
PostToolUse/Bash	Missing sound alarms	Warns Claude to recreate with sound alarm
PostToolUse/Bash	Banned short sounds used	Warns Claude to use only approved sounds (>= 1.4s)

Execution

Parse $ARGUMENTS and run the management script:

/usr/bin/env bash << 'PRODUCTIVITY_TOOLS_HOOKS_SCRIPT'
set -euo pipefail

ACTION="${ARGUMENTS:-status}"

# Auto-detect plugin root
detect_plugin_root() {
    if [[ -n "${CLAUDE_PLUGIN_ROOT:-}" ]]; then
        echo "$CLAUDE_PLUGIN_ROOT"
        return
    fi
    local marketplace="$HOME/.claude/plugins/marketplaces/cc-skills/plugins/productivity-tools"
    if [[ -d "$marketplace/hooks" ]]; then
        echo "$marketplace"
        return
    fi
    local cache_base="$HOME/.claude/plugins/cache/cc-skills/productivity-tools"
    if [[ -d "$cache_base" ]]; then
        local latest
        latest=$(ls -1 "$cache_base" 2>/dev/null | grep -E '^[0-9]+\.[0-9]+' | sort -V | tail -1)
        if [[ -n "$latest" && -d "$cache_base/$latest/hooks" ]]; then
            echo "$cache_base/$latest"
            return
        fi
    fi
    echo ""
}

PLUGIN_DIR="$(detect_plugin_root)"
if [[ -z "$PLUGIN_DIR" ]]; then
    echo "ERROR: Cannot detect productivity-tools plugin installation" >&2
    exit 1
fi

bash "$PLUGIN_DIR/scripts/manage-hooks.sh" "$ACTION"
PRODUCTIVITY_TOOLS_HOOKS_SCRIPT

Post-Action Reminder

After install/uninstall 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
/productivity-tools:hooks status

# Install the calendar-reminder-sync hook
/productivity-tools:hooks install

# Uninstall hooks
/productivity-tools:hooks uninstall

Troubleshooting

Issue	Cause	Solution
jq not found	jq not installed	brew install jq
bun not found	bun not installed	brew install bun
Plugin root not found	Plugin not installed	Re-install via marketplace
Hooks not working	Session not restarted	Restart Claude Code session
Reminders not created	Hook not installed	Run /productivity-tools:hooks install
Sound alarm not playing	Notifications disabled	Enable in System Settings > Notifications > Calendar

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.