add-exercise_skill

Overview

This skill adds a new exercise type to vibereps by generating the JSON config and the corresponding pose-detection logic. It streamlines creating detection rules, thresholds, and user instructions so the exercise is trackable by the tracker. It’s designed for quick, repeatable addition of common motion patterns.

How this skill works

The skill inspects chosen MediaPipe landmark IDs and selects a detection type (angle, height_baseline, height_relative, tilt, distance, width_ratio, quadrant_tracking) to match the motion. It builds a JSON config following the template structure and injects landmark arrays and threshold values. Finally, it validates the config by running the tracker so detection behavior can be tested and refined.

When to use it

• You want to add a new exercise not yet in the app.
• You need pose-based repetition detection for a custom move.
• You are defining thresholds or alternate joint sets for left/right symmetry.
• You want a fast prototype for testing detection logic with the tracker.
• You need clear on-screen instructions and rep presets for an exercise.

Best practices

• Pick the detection type that matches the primary motion (angle for joint flexion, height for vertical moves, distance for parts approaching).
• Provide both left and right landmark sets when motion can be asymmetric.
• Set conservative thresholds, test live, then tighten values to reduce false positives.
• Write concise user instructions tied to threshold tokens (e.g., {down}, {up}).
• Run the tracker after each edit and iterate using real movement to validate detection.

Example use cases

• Add a squat using 'angle' detection with hip-knee-ankle joint arrays and down/up angle thresholds.
• Create calf raises using 'height_baseline' to measure ankle vertical movement from a baseline.
• Implement jumping jacks via 'height_relative' to detect hands moving above a reference point.
• Build torso twists using 'width_ratio' to monitor shoulder/hip width changes.
• Define arm circles with 'quadrant_tracking' to follow circular wrist motion.