tether

name	tether
description	Tether (install/uninstall) productivity-tools hooks to ~/.claude/settings.json. Renamed from 'hooks' to avoid clashing with.
allowed-tools	Read, Bash, TodoWrite, TodoRead
argument-hint	[install|uninstall|status]
model	haiku
disable-model-invocation	true

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
# Note: $CLAUDE_PLUGIN_ROOT is injected into hook/MCP processes only, not skills.
# For skill scripts, use: cc-plugin-root <plugin-name>
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//hooks" ]]; 
             
            
        
    
     
}

PLUGIN_DIR=
 [[ -z  ]]; 
      >&2
     1


bash  
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:tether status

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

# Uninstall hooks
/productivity-tools:tether 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:tether 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.