Pp Strava

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/productivity/strava/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Strava — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the strava-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install strava --cli-only

2. Verify: strava-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

go install github.com/mvanhorn/printing-press-library/library/productivity/strava/cmd/strava-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Use strava-pp-cli when an agent needs to query an athlete's historical training data, compute fitness metrics unavailable from the Strava web interface, manage activities in bulk, or build a training analysis pipeline. It is the right choice when the question involves aggregating across more than 5 activities, involves stream-level data (heart rate, power, GPS), or requires offline access to Strava data.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Local state that compounds

• segments progress — See your entire effort history on a segment — date, time, avg power, avg HR, delta from PR — so you can track if you're actually improving.

  Use this when an agent needs to assess whether an athlete is progressing on a target training segment over a season.

  strava-pp-cli segments progress 229781 --json --select start_date,elapsed,avg_watts,delta_pr_seconds

• training load — See your Chronic Training Load, Acute Training Load, and Training Stress Balance as sparklines so you can spot overtraining or undertaper before a race.

  Use when an agent needs to assess an athlete's fitness/fatigue state and readiness for an upcoming event.

  strava-pp-cli training load --weeks 12 --ftp 285 --agent

• training zones — See how many minutes per week you actually spent in each heart rate or power zone, so you can tell if your training distribution matches your plan.

  Use when evaluating whether a training block was executed as prescribed (polarized, sweet-spot, base).

  strava-pp-cli training zones --weeks 8 --type Run --zone-type heartrate --agent

• athlete power-curve — See your best mean power for every standard duration (1s to 60min) so you can identify strengths, weaknesses, and fitness changes across seasons.

  Use when an agent needs to characterize a cyclist's physiological profile or compare peak power across training blocks.

  strava-pp-cli athlete power-curve --since 2025-01-01 --weight 75 --agent

• activities drift — Measure aerobic decoupling in an activity — the ratio of HR rise to pace drop in the second half — to assess aerobic fitness without lab testing.

  Use when an agent needs to identify which long runs or rides showed aerobic decoupling, indicating the athlete was above their aerobic threshold.

  strava-pp-cli activities drift --min-duration 45m --since 2025-01-01 --threshold 5 --agent

• segments kom-gap — See exactly how far you are from the KOM on each starred segment, ranked by the gap you're most likely to close.

  Use when an agent needs to surface the most achievable KOM targets for a training plan or pre-ride goal setting.

  strava-pp-cli segments kom-gap --top 10 --agent

Agent-native plumbing

• activities bulk-update — Update gear, name template, or description across hundreds of activities at once with a preview-before-commit safety net.

  Use when an agent needs to mass-migrate a gear assignment after equipment replacement or retroactively organize a training block's activities.

  strava-pp-cli activities bulk-update --type Ride --after 2024-01-01 --set-gear b12345678 --dry-run

• gear status — See total mileage on each shoe and bike, your configured replacement threshold, and an estimated retirement date based on your recent usage rate.

  Use when an agent needs to check whether any gear is approaching retirement before an important race.

  strava-pp-cli gear status --threshold shoes=500mi --agent

Command Reference

activities — Manage activities

• strava-pp-cli activities create-activity — Creates a manual activity for an athlete, requires activity:write scope.
• strava-pp-cli activities get-activity-by-id — Returns the given activity that is owned by the authenticated athlete.
• strava-pp-cli activities update-activity-by-id — Updates the given activity that is owned by the authenticated athlete. Requires activity:write.

athlete — Manage athlete

• strava-pp-cli athlete get-logged-in — Returns the currently authenticated athlete.
• strava-pp-cli athlete get-logged-in-activities — Returns the activities of an athlete for a specific identifier. Requires activity:read.
• strava-pp-cli athlete get-logged-in-clubs — Returns a list of the clubs whose membership includes the authenticated athlete.
• strava-pp-cli athlete get-logged-in-zones — Returns the the authenticated athlete's heart rate and power zones. Requires profile:read_all.
• strava-pp-cli athlete update-logged-in — Update the currently authenticated athlete. Requires profile:write scope.

athletes — Manage athletes

clubs — Manage clubs

• strava-pp-cli clubs <id> — Returns a given a club using its identifier.

gear — Manage gear

• strava-pp-cli gear <id> — Returns an equipment using its identifier.

routes — Manage routes

• strava-pp-cli routes <id> — Returns a route using its identifier. Requires read_all scope for private routes.

segment-efforts — Manage segment efforts

• strava-pp-cli segment-efforts get-by-id — Returns a segment effort from an activity that is owned by the authenticated athlete. Requires subscription.
• strava-pp-cli segment-efforts get-efforts-by-segment-id — Returns a set of the authenticated athlete's segment efforts for a given segment. Requires subscription.

segments — Manage segments

• strava-pp-cli segments explore — Returns the top 10 segments matching a specified query.
• strava-pp-cli segments get-by-id — Returns the specified segment.
• strava-pp-cli segments get-logged-in-athlete-starred — List of the authenticated athlete's starred segments.

uploads — Manage uploads

• strava-pp-cli uploads create — Uploads a new data file to create an activity from. Requires activity:write scope.
• strava-pp-cli uploads get-by-id — Returns an upload for a given identifier. Requires activity:write scope.

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

strava-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Check training readiness before a race

strava-pp-cli training load --weeks 8 --ftp 285 --agent --select ctl,atl,tsb,label

Shows TSB (freshness) for each of the past 8 weeks; negative TSB = fatigue, positive = fresh. Ideal for race week targeting TSB > 10.