apple-health-skill_skill

Overview

This skill lets you talk to your Apple Health data using natural language. Ask about workouts, heart rate trends, activity rings, VO2 Max, and other fitness metrics. It connects to a sync service that gives the AI agent access to your Apple Health records so the coach can answer personalized questions and generate training guidance.

How this skill works

The skill reads synced Apple Health metrics through an API and exposes endpoints for chat, workouts, performance charts, and athlete profile data. Use the coach chat endpoint to ask questions in plain English—behind the scenes the agent queries your workouts, heart rate, sleep, and derived performance stats. Additional endpoints return structured data like scheduled workouts, PMC (CTL/ATL/TSB), performance stats, and chat history for programmatic access.

When to use it

• Ask about recent trends (resting heart rate, VO2 Max, sleep, activity rings).
• Get a quick, structured workout without signing in.
• Check fatigue and form before scheduling a hard training session.
• Retrieve scheduled workouts for a specific date range.
• Fetch performance metrics (FTP, threshold paces, HR zones) for planning.

Best practices

• Use the coach chat as the primary interface for natural-language queries and context-aware advice.
• Always check TSB from the PMC endpoint before recommending intense workouts (TSB < -20 indicates fatigue).
• Provide date ranges in YYYY-MM-DD format for all date-based requests.
• Use the free WOD endpoint for quick workout suggestions when authentication is not available.
• Pass the API key in the designated header for authenticated endpoints to access personal health data securely.

Example use cases

• Ask: 'How has my resting heart rate changed over the last month?' to get trend analysis and actionable insights.
• Request: 'Compare my running pace this month vs last month' to identify performance changes and tempo adjustments.
• Generate: a 45-minute run workout for today using the WOD endpoint when you need a quick plan.
• Check PMC to decide whether to take a rest day based on recent fatigue and form metrics.
• Retrieve scheduled workouts between two dates to sync with your calendar or training app.