← Skillful-Alhazen

Coach

The Coach skill provides personal health and fitness monitoring. It ingests Apple HealthKit data (via the Health Auto Export iOS app), computes daily metric aggregates in TypeDB, tracks goals and appointments, and surfaces actionable recommendations when metrics regress.

Core Capabilities

  • Data ingestion — Parse daily JSON, CSV, workout files, or full ZIP exports from Health Auto Export
  • Metric aggregation — Daily aggregates for activity (steps, distance, calories), cardiovascular (RHR, HRV, BP), and sleep metrics
  • Run detection — Heuristic identification of running workouts from composite metrics
  • Goal tracking — Set and monitor health goals with progress
  • Appointment management — Track providers and upcoming appointments
  • Heartbeat protocol — 12-hour cycle with escalation rules for metric regressions
  • Lab results — Ingest and track lab panels over time
  • Nutrition — Parse MyFitnessPal/Cronometer exports, track daily intake
  • Assessments — Claude-authored health summaries with supporting data

Data Model

Entity Purpose
coach-health-seeker The operator’s health profile
coach-daily-metric One metric aggregate for one day
coach-sleep-record Per-night sleep data
coach-workout Individual workout sessions
coach-health-goal Tracked goals with targets
coach-appointment Scheduled healthcare visits
coach-provider Healthcare providers
coach-trend 7d/30d metric deltas
coach-recommendation-note Actionable suggestions

Heartbeat Protocol

The heartbeat runs on 12-hour cycles and escalates when:

  • Resting heart rate regresses >5 bpm from 7-day baseline
  • Weight spikes >2 lbs in 48 hours
  • Sleep deficit exceeds 2 hours below goal for 3+ consecutive nights
  • Daily steps decline >30% from 7-day average
  • HRV crashes >15% below 7-day baseline
  • Pipeline staleness (no data ingested in 48+ hours)

Key Commands

# Ingestion
uv run python coach.py ingest-zip --path ~/Downloads/export.zip
uv run python coach.py ingest-daily --path ~/exports/2026-05-20.json
uv run python coach.py ingest-workouts --path ~/exports/workouts.csv
uv run python coach.py ingest-lab-pdf --path ~/labs/bloodwork.pdf --panel-name "Q2 2026"

# Querying
uv run python coach.py latest
uv run python coach.py trends
uv run python coach.py sleep-summary --days 7
uv run python coach.py workout-history --limit 10
uv run python coach.py show-metric --name resting_heart_rate --days 30
uv run python coach.py nutrition-summary --days 7

# Goals & Appointments
uv run python coach.py add-goal --name "10k steps" --metric steps --target 10000
uv run python coach.py list-goals
uv run python coach.py add-appointment --provider "Dr. Smith" --date 2026-06-15 --type checkup
uv run python coach.py list-appointments

# Analysis
uv run python coach.py gather-assessment-data
uv run python coach.py save-assessment --content "..."
uv run python coach.py pipeline-status
uv run python coach.py add-recommendation --content "..." --priority high

Dashboard

The Coach dashboard provides:

  • Overview — Key metrics at a glance, recent trends
  • Trends — Time-series charts for selected metrics
  • Sleep — Nightly breakdown with sleep stage analysis
  • Workouts — Session log with type detection
  • Appointments — Calendar view of upcoming visits

When to Use

  • “Ingest my health data” — parse new exports
  • “How am I doing?” — latest metrics + trend analysis
  • “Run heartbeat” — check for regressions and generate recommendations
  • “Track a goal” — add/update health objectives
  • “When’s my next appointment?” — provider and scheduling queries