Garmin Tracker

Use this skill when the user asks to sync, rebuild, or validate Garmin training data in garmin_tracking.json (workspace root).

Runtime Prerequisite

• playwright-core must be available in the runtime where the skill executes.
• If you get MODULE_NOT_FOUND: playwright-core, install it in the active workspace:

npm install playwright-core

Scope

• This skill is intentionally narrow: goal tracking for Garmin runners/users (training history summary + upcoming training-plan).
• Out of scope by default: deep telemetry scraping (GPS route internals, split arrays, cadence/power/elevation raw series).
• Out of scope: nutrition workflow orchestration or external workflow integration.

Hard Rules

• Control start date is fixed: 2026-02-01.
• Keep these top-level fields: lastUpdate, planName, currentWeek, summary, history, upcoming, recurring_activities.
• summary.to must always be today (YYYY-MM-DD).
• Activities must use this canonical shape:
  • type
  • distanceKm
  • durationSec
  • avgPaceSecPerKm
  • avgHrBpm
  • calories
  • sourceId

Browser Flow (Garmin)

1. Open Garmin activities list page and collect activities from 2026-02-01 onward.
2. Open Garmin training plan page (/app/training-plan) and refresh currentWeek + upcoming.
3. Keep extraction objective: list/table fields only. No GPS/splits/cadence/power deep scrape.
4. If browser action fails, do one in-tool recovery sequence first (tabs -> focus -> fresh snapshot) before escalation.

Session/Auth Contract

• The user signs in locally to Garmin in the browser profile used by OpenClaw.
• If Garmin page indicates signed-out session, ask user to sign in and then rerun.
• Do not store user credentials in the skill files.

Authentication (Priority Order)

Use this strict order:

1. Logged browser session (preferred): reuse existing authenticated Garmin session.
2. Guided manual login in the controlled browser/profile.
3. Credentials fallback only if browser login is not possible or explicitly rejected by the user.

sync_training_plan.mjs supports:

• --auth-source auto (default): use existing browser session; if signed out and credentials are available, try credentials login.
• --auth-source browser: never use credentials; require manual login.
• --auth-source credentials: require credentials and attempt login directly.

Authentication (User Guidance)

If the user is signed out, guide with explicit steps:

1. Ask for manual sign-in in the controlled browser profile: https://connect.garmin.com/signin/ -> https://connect.garmin.com/app/training-plan -> rerun sync.
2. If browser sign-in is not possible, request credentials as fallback and run credentials mode.

Notes: