athlete-snapshot

Recompute physiological metrics from the local Strava database and write a timestamped snapshot.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Compute and store a complete physiological profile snapshot, track metric evolution, and alert on significant changes. Use when the user asks to update their profile, refresh metrics, check how metrics have changed, or asks about their physiological state.

Core Features & Use Cases

  • Recomputes all variable physiological metrics from the local activity database
  • Writes a timestamped snapshot to the athlete_snapshots table
  • Generates alerts when metrics cross thresholds
  • Use case: When users want to refresh or review changes in their physiological state over time.

Quick Start

Run athlete-snapshot to recompute and store the latest physiological snapshot from the Strava activity database.

Frequently Asked Questions about athlete-snapshot

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

FAQPage Schema
How do I recompute physiological fitness metrics from a Strava activity database?

Athlete-snapshot recomputes physiological metrics by reading your local Strava activity database, calculating current CTL and VDOT values, and writing a timestamped JSON snapshot to the athlete_snapshots table.

What are physiological snapshots used for in fitness tracking?

Physiological snapshots track metric evolution over time and generate alerts when fitness variables cross defined thresholds, helping you understand changes in your physiological state across workouts by storing timestamped profiles for comparison.

Can I refresh partial physiological metrics instead of recomputing the entire profile?

Yes, you can perform a partial refresh. The CLI supports both full and partial recomputation of variable physiological metrics, allowing you to update specific metrics without processing the entire local activity database.

Does athlete-snapshot work without a Strava API token?

No, a valid token is required. The Skill includes error handling for missing token or activities, ensuring the local Strava cache and database are properly authenticated before recomputing physiological metrics.

How do I track changes in CTL and VDOT over time?

Track CTL and VDOT changes by running snapshot refreshes periodically. Each execution writes a timestamped record to the athlete_snapshots table, enabling you to compare metric evolution and trigger alerts when thresholds are crossed.