garmin-runcoach

Fetch Garmin Connect running and sleep data into markdown summaries.

Updated Jul 11, 2022
One-click install
npx skills add https://github.com/zhengfran/dotconfig --skill garmin-runcoach
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: garmin-runcoach
Source: https://github.com/zhengfran/dotconfig/tree/main/tools/ai/agents/skills/garmin-runcoach
Command: npx skills add https://github.com/zhengfran/dotconfig --skill garmin-runcoach

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill requires garminconnect, python3, awk, and includes scripts (resource) components.

What problem does it solve?

It eliminates the manual effort of collecting Garmin Connect running and sleep data and converting it into a clear coaching-ready snapshot.

Core Features & Use Cases

  • Automated sync + local JSON snapshot: Pulls recent running activities and sleep data from Garmin Connect into a local garmin-latest.json file for a defined date range.
  • Coach-friendly summary generation: Parses the JSON and produces a compact garmin-summary.md with running totals, longest run, latest run, and recent sleep (best-effort extraction).
  • Sync troubleshooting on-device: Provides practical failure-mode guidance for common issues like login problems, rate limiting (429), and missing Python/garminconnect setup.

Quick Start

Run a full sync and summary for the last 14 days by executing: garmin-runcoach all --days 14.

Frequently Asked Questions about garmin-runcoach

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

FAQPage Schema
How do I export Garmin Connect running data into a local JSON file?โ–ผ

You can export Garmin Connect running data into a local JSON file by using this Python CLI to authenticate and fetch activities for a specified date range, saving outputs directly to garmin-latest.json.

Can I generate a coaching summary from Garmin sleep and running activities?โ–ผ

Yes, you can generate a coaching summary from Garmin sleep and running activities by parsing local JSON data to output a compact markdown file featuring running totals, recent sleep, and recovery signals.

Do I need Python and garminconnect to fetch Garmin training summaries?โ–ผ

Yes, you need Python3 and the garminconnect client to fetch Garmin training summaries, which requires authenticated access via GARMIN_EMAIL and GARMIN_PASSWORD environment variables or a ~/.netrc file.

What is the best way to automate Garmin run coaching reports for the last 14 days?โ–ผ

The best way to automate Garmin run coaching reports for the last 14 days is running a single CLI command that syncs activities and sleep, then automatically generates a markdown training summary.

Why does my Garmin Connect API sync fail with a 429 error?โ–ผ

Your Garmin Connect API sync fails with a 429 error due to rate limiting; this tool provides built-in troubleshooting guidance for resolving rate limits, login failures, and missing Python dependencies.