| name | workout-explainer |
| description | Translates planned workouts into clear execution cues, purpose, mistakes to avoid, and substitutions. |
| metadata | [object Object] |
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
- Provide the
Workoutobject and user capability context (experience, recent runs). - Return execution cues, purpose, common mistakes, and two substitutions.
- 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.tswithworkout-explainerintent.
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_invokedwithworkout_type,experience,safety_flags.