race-strategy-builder

Generates race-day pacing and fueling strategies with contingency plans. Use when user has an upcoming race, asks for race preparation advice, or wants a printable race-day plan with segment pacing and fueling schedule.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill serves as a comprehensive race-day strategy generator, providing personalized pacing, fueling schedules, and contingency plans for athletes. By analyzing training history, course elevation, and weather data, it delivers a structured execution plan designed to optimize performance and help runners navigate unexpected race-day variables with confidence.

Use Cases

  • Marathon Pacing Strategy: Generate a segment-by-segment pacing guide that accounts for specific course elevation profiles and target finish times to avoid early burnout.
  • Fueling and Hydration Planning: Create a timed nutrition schedule specifying carbohydrate and fluid intake milestones based on the runner's physiology and race duration.
  • Weather and Terrain Contingencies: Develop 'Plan B' strategies for adverse conditions such as high heat, heavy winds, or particularly challenging uphill sections.
  • Race-Day Preparation: Produce a printable 'cheat sheet' or shareable digital card that summarizes key tactics and fueling steps for quick reference during the event.
namerace-strategy-builder
descriptionGenerates race-day pacing and fueling strategies with contingency plans. Use when user has an upcoming race, asks for race preparation advice, or wants a printable race-day plan with segment pacing and fueling schedule.
short-descriptionRace-day pacing, fueling, and contingency plan generator.

When Claude should use this skill

  • When the user sets up a race event or asks for race pacing guidance
  • Prior to race week to deliver printable/shareable strategy
  • When user requests race preparation or race-day tactics

Invocation guidance

  1. Provide UserProfile, TrainingHistory, target race distance/date, course notes (elevation, weather).
  2. Produce pacing plan by segment, fueling schedule, and contingencies (heat, hills).
  3. Keep recommendations conservative if recent load is low or injury flags exist.

Input schema

See references/input-schema.json.

Output schema

See references/output-schema.json.

Integration points

  • UI: Race setup flow and shareable race card.
  • API: v0/app/api/race/strategy (new).
  • Export: Optionally generate text for notes and chat share via v0/lib/enhanced-ai-coach.ts.

Safety & guardrails

  • No medical advice; if user reports pain/injury, advise deferring race or adjusting pace drastically.
  • Clamp pacing to safe ranges based on recent easy pace; avoid aggressive negative splits for beginners.
  • Emit SafetyFlag when hydration/fueling cannot be recommended due to missing data.

Telemetry

  • Emit ai_skill_invoked and ai_plan_generated with race_distance, fueling_steps, safety_flags.