workout-explainer

majiayu000's avatarfrom majiayu000

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.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026
[Tutoring and Explanations]

When & Why to Use This Skill

The Workout Explainer skill bridges the gap between complex fitness planning and practical execution. It provides users with clear, beginner-friendly guidance by translating workout routines into actionable cues, explaining the intent behind each session, and offering safe exercise substitutions to prevent injury and improve training efficiency.

Use Cases

  • Pre-workout Preparation: Providing clear 'how-to' instructions and execution cues when a user is unsure how to perform a specific session or exercise.
  • Form and Safety Guidance: Identifying common mistakes to avoid and implementing safety guardrails, such as suggesting easier alternatives if the intensity exceeds the user's capability.
  • Educational Coaching: Explaining the purpose and intent of a workout to help users understand the 'why' behind their training, fostering better engagement and long-term progress.
nameworkout-explainer
descriptionTranslates 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.
short-descriptionExplains workouts with cues, intent, and safe substitutions.

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.
workout-explainer – AI Agent Skills | Claude Skills