flow-club/vibereps
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
FAQ
No. The wizard edits settings.json to update or append PostToolUse and Notification hooks while preserving other keys and hooks.
How do I add a custom exercise?
Run /add-exercise in Claude Code for guided creation or manually add a JSON config file to the exercises/ directory, then re-run setup if needed.
3 skills
This skill guides first-time Vibereps setup, guiding exercise mode, selections, custom options, and hook configuration for a ready-to-use tracker.
This skill helps you add a new exercise to vibereps by generating a JSON config and determining the appropriate detection type.
This skill helps you manage and test the vibereps exercise tracker by launching, restarting, or killing instances and starting fresh.
