matched-activities

Group Run activities by route similarity and report pace progression.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Decodes and groups runs that share the same route signature and shows pace progression for each matched group, helping runners understand when they have repeated routes and whether performance has improved.

Core Features & Use Cases

  • Route-signature grouping: clusters activities by polyline similarity or start/end coordinates to identify repeats.
  • Pace progression per group: displays pace trends across dates and highlights improvements or declines.
  • Memory persistence: records coaching observations after presenting results to enrich memory with meaningful insights.

Quick Start

Run the matched-activities skill to group your runs by route similarity and view pace progression for matched routes.

Frequently Asked Questions about matched-activities

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

FAQPage Schema
How do I group Strava runs by route similarity to track pace progression?

Group Strava runs by route similarity using polyline decoding or start and end coordinate signatures to identify repeated routes and display pace progression trends. This allows you to compare performance across the same routes over time.

How does polyline similarity work for matching repeated running activities?

Polyline similarity matches repeated running activities by decoding route data into coordinate signatures and clustering runs that share the same path. It evaluates geometric similarity to form groups with a minimum number of occurrences for reliable pace tracking.

Can I analyze pace progression for specific Strava run groups within a custom time window?

Yes, you can analyze pace progression for Strava run groups within a configurable time window. The analysis operates exclusively on Run activities, filtering data by your specified dates to calculate and report pace trends for matched routes.

What is the best way to export grouped Strava activity data for downstream training analytics?

The best way to export grouped Strava activity data for downstream training analytics is using the CLI JSON output. It provides structured route grouping and pace progression data while gracefully handling missing tokens and persisting coaching observations to memory.

Does route grouping handle missing Strava API tokens or incomplete activity data?

Yes, route grouping handles missing Strava API tokens and incomplete activity data gracefully. The system recovers from common errors automatically, ensuring that missing data does not interrupt the pace progression analysis or the JSON output generation.

How many repeated routes are needed to form a valid matched activity group?

A valid matched activity group requires a minimum number of occurrences configured by the user. This threshold ensures that pace progression analytics are only reported for routes repeated enough times to generate meaningful training insights.