Workout Explainer

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

majiayu000 Updated 567 repo stars

File contents

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.

majiayu000/claude-skill-registry-data/tree/main/development/workout-explainer commit 46f25efdcd

Frequently asked questions

npx skillmds@latest add majiayu000/workout-explainer-2