run-race-predictor

Predict 5k, 10k, half-marathon, and marathon times using Riegel and VDOT methods.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/AlvaroLaraFF/strava-coach --skill run-race-predictor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-race-predictor
Source: https://github.com/AlvaroLaraFF/strava-coach/tree/main/.claude/skills/run-race-predictor
Command: npx skills add https://github.com/AlvaroLaraFF/strava-coach --skill run-race-predictor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires strava, and includes scripts (resource) components.

What problem does it solve?

Predict race times for 5k / 10k / half marathon / marathon from the user's recent best efforts. Use when the user asks "for what time am I ready", "race predictor", "when can I run a sub-X".

Core Features & Use Cases

  • Anchor the race by selecting the best recent effort and compute predicted times for 5k, 10k, half marathon, and marathon using Riegel and Daniels VDOT methods.
  • Backfill missing best_efforts from stored activities and gracefully handle authentication issues.
  • Output a structured JSON payload with the anchor, optional VDOT, predicted times, and the pool size; trigger a memory note post-run.

Quick Start

Run the predictor against your recent runs to obtain predicted finish times.

Frequently Asked Questions about run-race-predictor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I predict my marathon time from recent Strava runs?

Predict marathon times from recent Strava runs by analyzing your best efforts using Riegel and VDOT methods. The predictor anchors your fastest recent run and calculates estimated finish times for 5k, 10k, half marathon, and marathon distances.

What running data do I need to estimate race finish times?

To estimate race finish times, you need stored best efforts from recent runs. If missing data is detected, the predictor backfills your best efforts from stored Strava activities to ensure accurate VDOT and Riegel calculations.

Can I use VDOT and Riegel formulas to check if I am ready for a sub-X race?

Yes, you can use VDOT and Riegel formulas to check if you are ready for a sub-X race. The predictor evaluates your recent best efforts to calculate achievable finish times across 5k, 10k, half marathon, and marathon distances.

Does the race predictor work without complete Strava best efforts?

The race predictor works without complete Strava best efforts by backfilling missing data from stored activities. It also gracefully handles authentication issues to output structured JSON with available anchors and pool sizes.

What is the difference between Riegel and VDOT for running performance prediction?

Riegel and VDOT are both used for running performance prediction. Riegel uses a fatigue factor based on distance, while VDOT calculates aerobic capacity; the predictor outputs structured JSON comparing both methods using your anchor effort.