setup-vibereps_skill

Overview

This skill guides first-time setup for the vibereps exercise tracker with a step-by-step wizard. It helps users pick standing or seated modes, select exercises, add custom movements, locate the installation, and wire vibereps into your Claude hooks. The result is an automated tracker that runs when Claude edits files and notifies you when tasks complete.

How this skill works

The wizard asks about preferred exercise mode and presents a filtered multi-select list of relevant exercises. It offers an option to create custom exercises via a CLI command or JSON files, detects the vibereps install path, and updates Claude's settings.json hooks to trigger the tracker and notifications. The skill edits settings safely, preserving other entries and using absolute paths, then shows a concise summary and useful commands.

When to use it

• Setting up vibereps for the first time
• Switching between standing and seated exercise modes
• Adding or selecting a curated set of exercises
• Installing hooks so tracker runs after Claude file edits
• Reconfiguring tracker location or notification behavior

Best practices

• Choose the closest mode (Standing, Seated, or both) to reduce irrelevant exercises
• Select a small set of core exercises to start, then expand or tune detection later
• Use absolute paths (no ~) when configuring hooks to avoid runtime errors
• Preserve existing settings.json content and only append or update PostToolUse/Notification hooks
• Test the tracker after setup with /test-tracker and tune detection with /tune-detection if reps miss counts

Example use cases

• Desk worker adds three seated stretches and a shoulder shrug routine to break up long editing sessions
• Home gym user enables standing mode with squats, push-ups, and jumping jacks for active short breaks
• Power user adds a custom exercise via /add-exercise for a niche movement and stores its JSON in exercises/
• Developer installs vibereps to $HOME/.vibereps and updates Claude hooks to run the tracker asynchronously when files are edited