swim-volume

Aggregate weekly and monthly swim distance, time, and sessions from Strava SQLite.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Reduces the guesswork of how much you swim by automatically summarizing swim activity into clear weekly and monthly volume, along with session counts.

Core Features & Use Cases

  • Weekly & Monthly Reports: Shows total distance (m), moving time (min), and sessions for each week and month.
  • Trend Insight: Provides a simple trend (increasing, steady, or decreasing) to help planning future workouts.
  • Use Case: When asked "how much do I swim?" this skill quickly returns a compact summary you can save or display.

Quick Start

Run the swim-volume script with --weeks to generate weekly and monthly swim-volume reports.

Frequently Asked Questions about swim-volume

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

FAQPage Schema
How do I track my swim volume from Strava history?

The script aggregates swim volume by reading the local Strava SQLite database, filtering for sport_type Swim, and grouping activities by ISO week and year-month to return total distance, moving time, and session counts.

Can I see my weekly and monthly swim distance trends?

Yes, the script provides weekly and monthly swim distance trends by grouping local Strava data into ISO weeks and year-months. It returns a trend indicator showing if your volume is increasing, steady, or decreasing.

Does this swim volume tracker require an internet connection to Strava?

No, the script analyzes swim volume entirely offline by querying the local Strava SQLite database. It filters locally stored sport_type Swim records to aggregate distance, moving time, and session counts.

How do I count my swimming sessions per week or month?

The script counts swimming sessions by filtering the local Strava database for sport_type Swim, grouping records by ISO week and year-month, and returning the total session counts for each period.

What is the best way to summarize swim moving time from my activities?

To summarize swim moving time, the script aggregates local Strava SQLite records by filtering for sport_type Swim and grouping by ISO week and year-month, returning total moving time in minutes.

What format does the swim volume report output for display?

The swim volume report outputs a JSON payload containing aggregated totals for distance, moving time, session counts, and trend indicators. This format is suitable for display interfaces and memory persistence.