apple-health-skill

What This Skill Does

The apple-health-skill empowers your AI agent to act as a personal fitness concierge by bridging the gap between your raw Apple Health data and natural language processing. By leveraging the Transition API, this skill allows users to query complex health metrics such as VO2 Max trends, resting heart rate history, and activity ring progress without manually navigating through health apps. Beyond mere data retrieval, it includes analytical capabilities like Performance Management Chart (PMC) tracking (CTL, ATL, TSB), allowing the agent to provide actionable insights into your training load, fatigue levels, and overall fitness form. Additionally, it offers a workout generation feature that can suggest structured training sessions tailored by sport and duration, making it a comprehensive tool for fitness enthusiasts looking to optimize their performance based on concrete, quantified data.

Installation

To integrate this skill into your OpenClaw environment, execute the command: clawhub install openclaw/skills/skills/nftechie/apple-health-skill. Once installed, ensure you have set up your data source by downloading the Transition app, granting the necessary Apple Health permissions, and generating an API key from the Settings > API Keys section. Finalize the configuration by adding the environment variable export TRANSITION_API_KEY="tr_live_..." to your shell profile, ensuring your agent has the authorization required to access your private health metrics securely.

Use Cases

• Personal Coaching: Have your agent analyze your recent workout volume to suggest whether you should push for a PR or prioritize a rest day.
• Trend Analysis: Ask for a comparative summary of your running performance or sleep quality over the past 90 days to track long-term progress.
• Workout Planning: Generate a quick 45-minute structured run or strength session whenever you need motivation or a pre-defined training structure.
• Performance Review: Use the performance stats and PMC charts to identify burnout risks before they manifest, using data-driven insights to adjust your training schedule.

Example Prompts

1. "Based on my training load from the last two weeks, do you recommend I take a rest day today or should I push for a high-intensity session?"
2. "Can you give me a 30-minute running workout plan that matches my current heart rate zones and fitness level?"
3. "Show me a summary of my VO2 Max trend for the last month and compare my average pace across all my bike rides this week versus last week."

Tips & Limitations

The Apple Health skill is highly effective for data-driven athletes, but keep in mind that the AI's suggestions are meant to support—not replace—professional medical advice. Always listen to your body first. Note that API usage is governed by rate limits: the free tier allows for 3 AI requests per day, so use them strategically for your most complex queries. When querying date ranges, ensure they are within the 90-day window to avoid errors. As this skill relies on the Transition API, ensure the app is synced regularly to provide the agent with the most up-to-date information.