| name | fitness-coach |
| description | This skill should be used when the user asks to "start fitness coaching", "open fitness coach", "launch exercise scoring", "run the fitness plugin", "练习健身", "打开健身教练", "开始运动评分", "运动打分", "健身打卡", or when Claude should open the pose-scoring fitness coach window from this plugin. |
| version | 0.1.0 |
Fitness-Coach — Real-time Pose Scoring via PoseLandmarker + WKWebView
Open a native macOS window that runs a real-time exercise coach using MediaPipe
PoseLandmarker. Import a standard exercise video to generate a pose template,
then score your movements in real-time against the template.
How It Works
- Record Standard: Import a video of the correct exercise form. The system
extracts body landmarks frame-by-frame to create a reference template.
- Real-time Scoring: Select a saved template, start the camera, and perform
the exercise. The system uses spatial normalization, cosine similarity, and
online DTW to score your form in real-time.
Prerequisites
The plugin ships a local Swift WKWebView host via @cloudgeek/glimpse.
Running npm install in the scripts directory installs the dependency.
Execution Steps
Step 1 — Ensure the local host is up to date
SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT}/scripts"
BINARY="$SCRIPTS_DIR/node_modules/@cloudgeek/glimpse/glimpse"
NEEDS_BUILD=0
if [ ! -x "$BINARY" ]; then
NEEDS_BUILD=1
else
GLIMPSE_DIR="$SCRIPTS_DIR/node_modules/@cloudgeek/glimpse"
for src in "$GLIMPSE_DIR"/glimpse.swift "$GLIMPSE_DIR"/Info.plist; do
[ "$src" -nt "$BINARY" ] && NEEDS_BUILD=1 && break
done
fi
if [ "$NEEDS_BUILD" -eq 1 ]; then
cd "$SCRIPTS_DIR" && npm install
fi
Step 2 — Launch the fitness coach window
node "${CLAUDE_PLUGIN_ROOT}/scripts/fitness-coach.mjs"
Optional overrides:
node "${CLAUDE_PLUGIN_ROOT}/scripts/fitness-coach.mjs" --width 1024 --height 768 --title "Fitness Coach"
Notes
- The command stays attached until the window is closed.
- If camera access is denied, a message prompts the user to enable it.
- MediaPipe PoseLandmarker model is loaded from Google CDN (~5MB, cached by WKWebView).
- Standard templates are stored in
~/.fitness-coach/standards/.
