garmin-pulse

What This Skill Does

The garmin-pulse skill is a specialized OpenClaw agent designed to bridge the gap between your wearable fitness data and local, searchable documentation. By automating the integration of Garmin Connect data into your local environment, this skill transforms raw fitness metrics into structured, human-readable markdown files. It captures a comprehensive range of health indicators including daily activity levels, sleep cycles, heart rate variability (HRV), stress metrics, body battery, SpO2 levels, and weight tracking. By persisting this information as daily markdown files in your local {baseDir}/health/ directory, the agent enables you to query your fitness history, identify trends, and maintain a historical archive of your personal well-being without relying on the browser-based dashboard.

Installation

To begin, ensure you have uv installed on your system. Install the skill using the OpenClaw CLI: clawhub install openclaw/skills/skills/freakyflow/garmin-pulse. Once installed, you must perform a one-time authentication. Run uv run {baseDir}/scripts/sync_garmin.py --setup --email [email protected] in your terminal. You will be prompted for your password securely via the system's getpass utility. Once the authentication tokens are cached in ~/.garminconnect, the skill can operate independently without further credential input for approximately one year.

Use Cases

This skill is ideal for users who want to perform long-term trend analysis on their health data, integrate their fitness metrics into personal knowledge management systems (like Obsidian or Logseq), or ask complex questions about their health recovery patterns. Because the data is stored in standard markdown files, you can easily combine your fitness metrics with your journals or task lists to see how your sleep quality correlates with your daily productivity or workload.

Example Prompts

1. "Check my health files and tell me if my average heart rate variability has improved over the last 7 days."
2. "Sync my data from yesterday and summarize my body battery and sleep quality for that day."
3. "Look at my health logs for last week and create a summary of my average stress levels compared to my activity volume."

Tips & Limitations

• Automation: Use the OpenClaw cron tool to schedule daily syncs so your files are always current.
• Data Privacy: Remember that the markdown files contain personal health data; ensure your directory permissions are set appropriately.
• Authentication: If you ever experience issues with the sync, check that your tokens haven't expired; simply re-run the setup command if they have.
• Limitations: The skill requires an active internet connection to communicate with Garmin servers during the sync phase, though files are generated locally for offline reading thereafter.