{"skill":{"slug":"apple-health-skill","displayName":"Apple Health Skill","summary":"Talk to your Apple Health data — ask questions about your workouts, heart rate, activity rings, and fitness trends using AI.","description":"---\nname: apple-health-skill\ndescription: Talk to your Apple Health data — ask questions about your workouts, heart rate, activity rings, and fitness trends using AI.\nhomepage: https://www.transition.fun\n---\n\n# Apple Health Skill\n\nChat with your Apple Health data using AI. Ask about your workouts, heart rate trends, activity rings, VO2 Max, and more. Powered by [Transition](https://www.transition.fun), which syncs with Apple Health to give AI agents access to your fitness data.\n\n## Setup\n\n1. Download [Transition](https://www.transition.fun) and grant Apple Health access\n2. Go to **Settings > API Keys** and tap **Generate New Key**\n3. Set the environment variable:\n\n```bash\nexport TRANSITION_API_KEY=\"tr_live_xxxxxxxxxxxxxxxxxxxxx\"\n```\n\n## No Auth Required\n\n### Workout of the Day\n\nGenerate a random structured workout — no account needed.\n\n```bash\ncurl \"https://api.transition.fun/api/v1/wod?sport=run&duration=45\"\n```\n\n**Parameters:**\n- `sport` — `run`, `bike`, `swim`, or `strength` (default: `run`)\n- `duration` — minutes, 10-300 (default: `45`)\n\n## Authenticated Endpoints\n\n**Base URL:** `https://api.transition.fun`\n**Auth:** Pass `X-API-Key` header on every request.\n\n### AI Coach Chat\n\nAsk questions about your Apple Health data. The AI coach has full context on your workouts and health metrics.\n\n```bash\ncurl -X POST -H \"X-API-Key: $TRANSITION_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"message\": \"How has my resting heart rate changed over the last month?\"}' \\\n  \"https://api.transition.fun/api/v1/coach/chat\"\n```\n\nExample questions:\n- \"How many workouts did I do this week?\"\n- \"What's my VO2 Max trend?\"\n- \"How has my sleep been trending this week?\"\n- \"Compare my running pace this month vs last month\"\n- \"Should I take a rest day based on my recent training?\"\n\n### Get Workouts\n\nRetrieve scheduled workouts for a date range.\n\n```bash\ncurl -H \"X-API-Key: $TRANSITION_API_KEY\" \\\n  \"https://api.transition.fun/api/v1/workouts?start=2026-02-09&end=2026-02-15\"\n```\n\n**Parameters:**\n- `start` — Start date (YYYY-MM-DD, required)\n- `end` — End date (YYYY-MM-DD, required)\n- Maximum range between `start` and `end` is 90 days.\n\n### Performance Management Chart (PMC)\n\nGet CTL (fitness), ATL (fatigue), and TSB (form) calculated from your Apple Health workouts.\n\n```bash\ncurl -H \"X-API-Key: $TRANSITION_API_KEY\" \\\n  \"https://api.transition.fun/api/v1/performance/pmc\"\n```\n\n### Performance Stats\n\nGet FTP, threshold paces, heart rate zones, and other metrics derived from your Apple Health data.\n\n```bash\ncurl -H \"X-API-Key: $TRANSITION_API_KEY\" \\\n  \"https://api.transition.fun/api/v1/performance/stats\"\n```\n\n### Athlete Profile\n\n```bash\ncurl -H \"X-API-Key: $TRANSITION_API_KEY\" \\\n  \"https://api.transition.fun/api/v1/profile\"\n```\n\n### Chat History\n\n```bash\ncurl -H \"X-API-Key: $TRANSITION_API_KEY\" \\\n  \"https://api.transition.fun/api/v1/coach/history\"\n```\n\n## Rate Limits\n\n| Tier | Read Endpoints | AI Endpoints |\n|------|---------------|-------------|\n| Free | 100/day | 3/day |\n| Paid | 10,000/day | 100/day |\n\n## Tips for Agents\n\n1. **Use coach chat as the primary interface.** It has full context on the user's Apple Health workouts, heart rate, and performance — just ask natural questions.\n\n2. **Check fatigue before recommending hard workouts.** Call `GET /api/v1/performance/pmc` and look at TSB. If TSB is below -20, the athlete is fatigued.\n\n3. **Use the free WOD endpoint for quick workouts.** No auth needed — great for users who just want a workout suggestion.\n\n4. **Date format is always YYYY-MM-DD** for all date parameters.\n","topics":["Health","Fitness"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":3672,"installsAllTime":127,"installsCurrent":15,"stars":3,"versions":1},"createdAt":1770672853420,"updatedAt":1778486238781},"latestVersion":{"version":"1.0.0","createdAt":1770672853420,"changelog":"Initial release of Apple Health Skill.\n\n- Chat with your Apple Health data using AI to get insights on workouts, heart rate, activity rings, VO2 Max, and more.\n- Integration with Transition app for secure syncing and API key authentication.\n- \"Workout of the Day\" endpoint available without authentication for quickly generating structured workouts.\n- Authenticated endpoints to chat with an AI health coach, retrieve workout history, access performance metrics and charts, and view athlete profiles.\n- Flexible API designed for agents, including guidance on using fatigue data and formatting dates.\n- Rate limits established for free and paid users.","license":null},"metadata":null,"owner":{"handle":"nftechie","userId":"s17c1httswb678enm5n4x6j4z1885dj4","displayName":"nftechie","image":"https://avatars.githubusercontent.com/u/2530972?v=4"},"moderation":null}