workout-context

Onboards athletes to the WorkoutContext MCP and builds personalized training plans from connected fitness data.

4|Updated May 17, 2026
One-click install
npx skills add https://github.com/agiantwhale/workoutcontext --skill workout-context-agiantwhale
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workout-context
Source: https://github.com/agiantwhale/workoutcontext/tree/main/assets/skills/workout-context
Command: npx skills add https://github.com/agiantwhale/workoutcontext --skill workout-context-agiantwhale

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Athletes using AI assistants for coaching get generic advice because the assistant has no access to their actual training data, history, or goals. This Skill walks athletes through connecting their fitness providers (Intervals.icu, Hevy, Oura, Withings) to the WorkoutContext MCP, learns their training background through conversation, and builds personalized, data-grounded training plans stored as playbook NOTE events on their Intervals.icu calendar. ## Core Features & Use Cases - Guided provider onboarding: Checks connection status via setup_status, walks athletes through connecting Intervals.icu, Strava, Hevy, Oura, and Withings using single-use magic links, and verifies activity data sources are flowing. - Personalized playbook creation: Builds discipline-specific training playbooks (running, cycling, strength, or freeform for other sports) from Markdown templates, populated with zones, PRs, weekly structure, progression rules, and recovery guidelines derived from real API data and conversation. - Strength programming with Hevy integration: Creates Hevy routines seeded with working weights from actual workout history, pairs them with Intervals.icu calendar events, and configures RPE-based training load tracking. - Ongoing plan maintenance: Detects drift between playbooks and actual training, updates plans when routines or events change, and integrates Oura/Withings recovery signals into training rules. - Use Case: A runner who also lifts connects Intervals.icu and Hevy, shares their marathon goal and recent PRs, and receives a running playbook with pace zones plus a strength routine with real working weights — both synced to their calendar and watch. ## Quick Start Ask the assistant to help you get started with WorkoutContext and connect your Intervals.icu account to build your first training plan.

Frequently Asked Questions about workout-context

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

FAQPage Schema
How do I connect Intervals.icu to my AI assistant for coaching?

Add the WorkoutContext MCP connector from workoutcontext.fit and sign in with your Intervals.icu account. The Skill's setup_status tool verifies the connection, and connect_<provider> tools generate single-use links to authorize additional providers like Hevy, Oura, or Withings.

How do I create a personalized training plan from my workout data?

After connecting providers, the Skill pulls your sport settings, fitness metrics, and workout history from the APIs, then combines them with a conversation about your goals and schedule. It saves the result as a dated playbook NOTE event on your Intervals.icu calendar.

Does WorkoutContext work without a Garmin or Coros watch?

Yes. An activity source is helpful but not required — the free Strava phone app can record and sync runs to Intervals.icu. Garmin and Coros watches add the ability to receive structured workouts pushed directly to the wrist.

Can I use Hevy strength routines without a Hevy Pro subscription?

No, Hevy routine creation requires a Hevy Pro subscription. Without Hevy, the Skill embeds the strength prescription directly in the Intervals.icu calendar event description with pre-computed training load instead.

What happens if I have no training history or fitness data?

The Skill uses a cold-start protocol: conversational pace and RPE instead of heart rate zones, walk/run progressions for new runners, and conservative weight discovery sessions for new lifters. Zones get populated after a few weeks of recorded data.

Why is my strength training not counting toward my training load?

Strength load is computed from session RPE using the Foster sRPE formula, so you must log RPE (1-10) on every working set in Hevy. Without RPE values, synced activities appear on the calendar but contribute zero load to the fitness chart.