# Send Garmin Health Analysis 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "garmin-health-analysis", "name": "Garmin Health Analysis", "source": "tencent", "type": "skill", "category": "数据分析", "sourceUrl": "https://clawhub.ai/eversonl/garmin-health-analysis", "canonicalUrl": "https://clawhub.ai/eversonl/garmin-health-analysis", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/garmin-health-analysis", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=garmin-health-analysis", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "CHANGELOG.md", "README.md", "SKILL.md", "config.example.json", "install.sh", "references/api.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/garmin-health-analysis" }, "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-health-analysis", "downloadUrl": "https://openagent3.xyz/downloads/garmin-health-analysis", "agentUrl": "https://openagent3.xyz/skills/garmin-health-analysis/agent", "manifestUrl": "https://openagent3.xyz/skills/garmin-health-analysis/agent.json", "briefUrl": "https://openagent3.xyz/skills/garmin-health-analysis/agent.md" } } ``` ## Documentation ### Garmin Health Analysis Query health metrics from Garmin Connect and generate interactive HTML charts. ### Two Installation Paths This skill supports two different setups: Clawdbot Skill (this guide) - Use with Clawdbot for automation and proactive health monitoring MCP Server (see MCP setup guide) - Use with standard Claude Desktop as an MCP server Choose the path that matches your use case. You can also use both simultaneously! ### 1. Install Dependencies pip3 install garminconnect ### 2. Configure Credentials You have three options to provide your Garmin Connect credentials: Option A: Clawdbot Config (Recommended - UI configurable) Add credentials to ~/.clawdbot/clawdbot.json: { "skills": { "entries": { "garmin-health-analysis": { "enabled": true, "env": { "GARMIN_EMAIL": "your-email@example.com", "GARMIN_PASSWORD": "your-password" } } } } } Tip: You can also set these through the Clawdbot UI in the Skills settings panel. Option B: Local Config File Create a config file in the skill directory: cd ~/.clawdbot/skills/garmin-health-analysis # or: cd /skills/garmin-health-analysis cp config.example.json config.json # Edit config.json and add your email and password config.json: { "email": "your-email@example.com", "password": "your-password" } Note: config.json is gitignored to keep your credentials secure. Option C: Command Line Pass credentials directly when authenticating: python3 scripts/garmin_auth.py login \\ --email YOUR_EMAIL@example.com \\ --password YOUR_PASSWORD ### 3. Authenticate Login to Garmin Connect and save session tokens: python3 scripts/garmin_auth.py login This uses credentials from (in priority order): Command line arguments (--email, --password) Local config file (config.json) Environment variables (GARMIN_EMAIL, GARMIN_PASSWORD) Clawdbot config (skills.entries.garmin-health-analysis.env) Session tokens are stored in ~/.clawdbot/garmin-tokens.json and auto-refresh. Check authentication status: python3 scripts/garmin_auth.py status ### Fetching Data Use scripts/garmin_data.py to get JSON data: # Sleep (last 7 days default) python3 scripts/garmin_data.py sleep --days 14 # Body Battery (Garmin's recovery metric) python3 scripts/garmin_data.py body_battery --days 30 # HRV data python3 scripts/garmin_data.py hrv --days 30 # Heart rate (resting, max, min) python3 scripts/garmin_data.py heart_rate --days 7 # Activities/workouts python3 scripts/garmin_data.py activities --days 30 # Stress levels python3 scripts/garmin_data.py stress --days 7 # Combined summary with averages python3 scripts/garmin_data.py summary --days 7 # Custom date range python3 scripts/garmin_data.py sleep --start 2026-01-01 --end 2026-01-15 # User profile python3 scripts/garmin_data.py profile Output is JSON to stdout. Parse it to answer user questions. ### Generating Charts Use scripts/garmin_chart.py for interactive HTML visualizations: # Sleep analysis (hours + scores) python3 scripts/garmin_chart.py sleep --days 30 # Body Battery recovery chart (color-coded) python3 scripts/garmin_chart.py body_battery --days 30 # HRV & resting heart rate trends python3 scripts/garmin_chart.py hrv --days 90 # Activities summary (by type, calories) python3 scripts/garmin_chart.py activities --days 30 # Full dashboard (all 4 charts) python3 scripts/garmin_chart.py dashboard --days 30 # Save to specific file python3 scripts/garmin_chart.py dashboard --days 90 --output ~/Desktop/garmin-health.html Charts open automatically in the default browser. They use Chart.js with a modern gradient design, stat cards, and interactive tooltips. ### Answering Questions User asksAction"How did I sleep last night?"garmin_data.py summary --days 1, report sleep hours + score"How's my recovery this week?"garmin_data.py body_battery --days 7, report average + trend"Show me my health for the last month"garmin_chart.py dashboard --days 30"Is my HRV improving?"garmin_data.py hrv --days 30, analyze trend"What workouts did I do this week?"garmin_data.py activities --days 7, list activities with details"How's my resting heart rate?"garmin_data.py heart_rate --days 7, report average + trend ### Body Battery (0-100) Garmin's proprietary recovery metric based on HRV, stress, sleep, and activity: High (75-100): Fully recharged, ready for high intensity Medium (50-74): Moderate energy, good for regular activity Low (25-49): Limited energy, recovery needed Very Low (0-24): Depleted, prioritize rest ### Sleep Scores (0-100) Overall sleep quality based on duration, stages, and disturbances: Excellent (90-100): Optimal restorative sleep Good (80-89): Quality sleep with minor issues Fair (60-79): Adequate but could improve Poor (0-59): Significant sleep deficiencies ### HRV (Heart Rate Variability) Measured in milliseconds, higher is generally better: Indicates nervous system balance and recovery capacity Track trends over time (increasing = improving recovery) Affected by sleep, stress, training load, illness Normal range varies by individual (20-200+ ms) ### Resting Heart Rate (bpm) Lower generally indicates better cardiovascular fitness: Athletes: 40-60 bpm Fit adults: 60-70 bpm Average adults: 70-80 bpm Sudden increases may indicate stress, illness, or overtraining ### Stress Levels Based on HRV analysis throughout the day: Low stress: Rest and recovery periods Medium stress: Normal daily activities High stress: Physical activity or mental pressure ### Health Analysis When users ask for insights or want to understand their trends, use references/health_analysis.md for: Science-backed interpretation of all metrics Normal ranges by age and fitness level Pattern detection (weekly trends, recovery cycles, training load balance) Actionable recommendations based on data Warning signs that suggest rest or medical consultation ### Analysis workflow Fetch data: python3 scripts/garmin_data.py summary --days N Read references/health_analysis.md for interpretation framework Apply the analysis framework: Status → Trends → Patterns → Insights → Recommendations Always include disclaimer that this is informational, not medical advice ### Authentication Issues "Invalid credentials": Double-check email/password, try logging into Garmin Connect web "Tokens expired": Run login again: python3 scripts/garmin_auth.py login ... "Too many requests": Garmin rate-limits; wait a few minutes and try again ### Missing Data Some metrics require specific Garmin devices (Body Battery needs HRV-capable devices) Historical data may have gaps if device wasn't worn New accounts may have limited history ### Library Issues If garminconnect import fails: pip3 install --upgrade garminconnect Garmin occasionally changes their API; update the library if requests fail ### Privacy Note Credentials are stored locally in ~/.clawdbot/garmin-tokens.json Session tokens refresh automatically No data is sent anywhere except to Garmin's official servers You can revoke access anytime by deleting the tokens file ### Comparison: Garmin vs Whoop FeatureGarminWhoopRecovery metricBody Battery (0-100)Recovery Score (0-100%)HRV trackingYes (nightly average)Yes (detailed)Sleep stagesLight, Deep, REM, AwakeLight, SWS, REM, AwakeActivity trackingBuilt-in GPS, many sport modesStrain score (0-21)StressAll-day stress levelsNot directly trackedAPIUnofficial (garminconnect)Official OAuthDevice typesWatches, fitness trackersWearable band only ### References references/api.md — Garmin Connect API details (unofficial) references/health_analysis.md — Science-backed health data interpretation garminconnect library — Python API wrapper Garmin Connect — Official web interface ### Version Info Created: 2026-01-25 Author: EversonL & Claude Version: 1.2.0 Dependencies: garminconnect, fitparse, gpxpy (Python libraries) License: MIT ## Trust - Source: tencent - Verification: Indexed source record - Publisher: eversonl - Version: 1.2.2 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-23T16:43:11.935Z - Expires at: 2026-04-30T16:43:11.935Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/garmin-health-analysis) - [Send to Agent page](https://openagent3.xyz/skills/garmin-health-analysis/agent) - [JSON manifest](https://openagent3.xyz/skills/garmin-health-analysis/agent.json) - [Markdown brief](https://openagent3.xyz/skills/garmin-health-analysis/agent.md) - [Download page](https://openagent3.xyz/downloads/garmin-health-analysis)