garmin-skill

What This Skill Does

The garmin-skill acts as an intelligent bridge between your athletic data stored in Garmin Connect and the OpenClaw AI agent. By leveraging the Transition API, this skill empowers you to perform deep analysis on your personal performance metrics without manually parsing complex spreadsheets or scrolling through the Garmin app. Whether you are tracking VO2 Max, analyzing training load, or examining your heart rate zones over long periods, this skill provides real-time, conversational access to your physiological data.

Installation

To begin using this skill, ensure you have an active OpenClaw environment installed. Run the following command in your terminal: clawhub install openclaw/skills/skills/nftechie/garmin-skill

After installation, you must integrate your data by downloading the Transition application, connecting your Garmin account, and generating an API key from the Settings dashboard. Once obtained, set your environment variable using export TRANSITION_API_KEY="tr_live_...". This key acts as the secure handshake required for all authenticated queries to the Garmin ecosystem.

Use Cases

This skill is designed for athletes, coaches, and fitness enthusiasts who require data-driven insights. Key use cases include:

• Automated Reporting: Generate summaries of weekly training volume compared to historical averages.
• Performance Monitoring: Track CTL (Fitness), ATL (Fatigue), and TSB (Form) using the Performance Management Chart (PMC) endpoint to prevent overtraining.
• Workout Planning: Fetch upcoming scheduled sessions or generate a spontaneous 'Workout of the Day' based on your preferred sport and duration.
• Hardware Synchronization: Directly push structured, custom-built workouts to your Garmin device, ensuring your training plan is always ready on your wrist.

Example Prompts

1. "Analyze my running volume for this month and let me know if I am trending towards overtraining based on my recent training load."
2. "What are my current heart rate zones and how have they evolved compared to my data from last year?"
3. "Push my long endurance cycle workout scheduled for Saturday directly to my Garmin watch."

Tips & Limitations

• Rate Limits: Be mindful of API usage; frequent requests may be throttled. Cache heavy analytical responses where possible.
• Data Privacy: Ensure you rotate your Transition API key periodically.
• Limitations: The performance metrics are dependent on the quality and frequency of data synced from your Garmin device; ensure your device is synced to Garmin Connect before running queries. The maximum date range for querying specific workouts is 90 days per request.