# Workout Explainer

> Translates planned workouts into execution cues, purpose explanations, and common mistakes to avoid. Use before workouts when user asks "what should I do?" or "how do I run this session?" with beginner-friendly guidance.

- Skill: `majiayu000/workout-explainer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/workout-explainer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/workout-explainer/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/workout-explainer

---


## When Claude should use this skill
- When the user opens a workout detail modal or asks "how do I do this workout?"
- During chat if the user needs clarifications or substitutions
- When user wants to understand workout purpose or execution details

## Invocation guidance
1. Provide the `Workout` object and user capability context (experience, recent runs).
2. Return execution cues, purpose, common mistakes, and two substitutions.
3. Keep guidance concise (<120 words) and beginner-friendly when experience is low.

## Input schema
See `references/input-schema.json`.

## Output schema
See `references/output-schema.json`.

## Integration points
- UI: Workout detail modal and plan screen tooltips.
- Chat: Served through `v0/app/api/chat/route.ts` with `workout-explainer` intent.

## Safety & guardrails
- If workout intensity mismatches user level, propose easier substitution and emit `SafetyFlag`.
- No medical advice; advise stopping on pain/dizziness.

## Telemetry
- Emit `ai_skill_invoked` with `workout_type`, `experience`, `safety_flags`.