# Workout Explainer

> Translates planned workouts into clear execution cues, purpose, mistakes to avoid, and substitutions.

- Skill: `majiayu000/workout-explainer-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/workout-explainer-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/workout-explainer-2/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-22
- Page: https://skillmd.com/skills/majiayu000/workout-explainer-2

---


## When Codex should use it
- 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.

## 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`.