apple-health-skill
by nftechie
Apple Apps & ServicesBrief
Talk to your Apple Health data — ask questions about your workouts, heart rate, activity rings, and fitness trends.
Description
What This Skill Does
Connects AI agents to Apple Health data via the Transition app. Enables natural language queries about workouts, heart rate trends, VO2 Max, sleep, and training load. Also provides a free workout generator that requires no account.
Exposes structured fitness metrics like CTL, ATL, and TSB alongside raw workout data, so agents can give context-aware training advice rather than just surfacing numbers.
When to Use It
- Ask how resting heart rate changed over the past month
- Check training fatigue before scheduling a hard workout
- Compare running pace across two months
- Get a structured 45-minute run workout without signing in
- Review weekly workout count and activity ring completion
Example Workflow
User asks: Should I do a hard workout today?
- 1
Call GET /api/v1/performance/pmc to retrieve current TSB value
- 2
Check if TSB is below -20, indicating accumulated fatigue
- 3
Call GET /api/v1/performance/stats to get heart rate zones and threshold paces
- 4
Call POST /api/v1/coach/chat with question about recent training load
Agent reports TSB of -24 and recommends a rest or easy day with supporting heart rate zone context
Requirements
- Transition app installed on iPhone (available at transition.fun)
- Apple Health access granted to Transition
- TRANSITION_API_KEY environment variable (generated in Transition app Settings > API Keys)
Installation
clawhub install nftechie/apple-health-skillRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.