workout-explainer

name	workout-explainer
description	Translates planned workouts into clear execution cues, purpose, mistakes to avoid, and substitutions.
metadata	{"short-description":"Explains workouts with cues, intent, and safe substitutions."}

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.