# Send Garmin Tracker to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "garmin-tracker", "name": "Garmin Tracker", "source": "tencent", "type": "skill", "category": "数据分析", "sourceUrl": "https://clawhub.ai/ricardotrevisan/garmin-tracker", "canonicalUrl": "https://clawhub.ai/ricardotrevisan/garmin-tracker", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/garmin-tracker", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=garmin-tracker", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "scripts/__tests__/fixtures/training-plan-lines.json", "scripts/__tests__/training_plan_parser.test.mjs", "scripts/reconcile_tracking.py", "scripts/sync_training_plan.mjs", "scripts/training_plan_parser.mjs" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "garmin-tracker", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T13:53:04.495Z", "expiresAt": "2026-05-06T13:53:04.495Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=garmin-tracker", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=garmin-tracker", "contentDisposition": "attachment; filename=\"garmin-tracker-1.0.2.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "garmin-tracker" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/garmin-tracker" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/garmin-tracker", "downloadUrl": "https://openagent3.xyz/downloads/garmin-tracker", "agentUrl": "https://openagent3.xyz/skills/garmin-tracker/agent", "manifestUrl": "https://openagent3.xyz/skills/garmin-tracker/agent.json", "briefUrl": "https://openagent3.xyz/skills/garmin-tracker/agent.md" } } ``` ## Documentation ### 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) Open Garmin activities list page and collect activities from 2026-02-01 onward. Open Garmin training plan page (/app/training-plan) and refresh currentWeek + upcoming. Keep extraction objective: list/table fields only. No GPS/splits/cadence/power deep scrape. 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: Logged browser session (preferred): reuse existing authenticated Garmin session. Guided manual login in the controlled browser/profile. 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: Ask for manual sign-in in the controlled browser profile: https://connect.garmin.com/signin/ -> https://connect.garmin.com/app/training-plan -> rerun sync. If browser sign-in is not possible, request credentials as fallback and run credentials mode. Notes: Authentication policy (browser-first vs credentials-first) may be configured by the operator for each environment. In containerized browser setups that expose a remote UI, use the configured noVNC/VNC endpoint to complete login when needed. In host-browser mode, sign in directly in the host browser profile configured in OpenClaw. ### Credentials Mode (Fallback) If browser sign-in is not possible, credentials mode can be used as fallback. Rules: Ask only what is strictly required (username/email + password, and 2FA code only if prompted). Use credentials only for the login action, then discard from working memory/context when possible. Never write credentials to MEMORY.md, garmin_tracking.json, logs, or skill files. Never echo credentials back in responses. After login success, continue with normal session-based flow. ### Data Rebuild Flow Read current garmin_tracking.json. Preserve planName and recurring_activities. Rebuild history from Garmin activities (>= control start date). Recompute summary from rebuilt history. Set summary.to to today and lastUpdate to current timestamp. ### Local Validator/Reconciler Script Use the bundled script for schema normalization and summary recomputation: python3 {baseDir}/scripts/reconcile_tracking.py --file garmin_tracking.json --write Check-only mode: python3 {baseDir}/scripts/reconcile_tracking.py --file garmin_tracking.json ### Training Plan Sync Script Use the bundled script to refresh currentWeek and upcoming from Garmin Training Plan: node {baseDir}/scripts/sync_training_plan.mjs --file garmin_tracking.json --write Credentials fallback example (last resort): node {baseDir}/scripts/sync_training_plan.mjs \\ --auth-source credentials \\ --garmin-email "user@example.com" \\ --garmin-password "***" \\ --file garmin_tracking.json \\ --write CDP resolution priority: --cdp-url (explicit override) OpenClaw config (browser.defaultProfile -> browser.profiles..cdpUrl) from --config path fallback to the script default CDP endpoint for local setups (http://127.0.0.1:) Override example: node {baseDir}/scripts/sync_training_plan.mjs --config data/config/openclaw.json --url "https://connect.garmin.com/app/training-plan" --file garmin_tracking.json --write ### Minimal Parser Tests Run parser fixtures: node --test {baseDir}/scripts/__tests__/training_plan_parser.test.mjs ### Final Checks File is valid JSON. No nutritionLog key exists. history[].activities[] are canonical. summary.to equals today. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: ricardotrevisan - Version: 1.0.2 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-29T13:53:04.495Z - Expires at: 2026-05-06T13:53:04.495Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/garmin-tracker) - [Send to Agent page](https://openagent3.xyz/skills/garmin-tracker/agent) - [JSON manifest](https://openagent3.xyz/skills/garmin-tracker/agent.json) - [Markdown brief](https://openagent3.xyz/skills/garmin-tracker/agent.md) - [Download page](https://openagent3.xyz/downloads/garmin-tracker)