health-guardian

What This Skill Does

Health Guardian is a proactive intelligence tool designed for AI agents to monitor human health metrics in real-time. Unlike passive health trackers, this skill focuses on predictive analysis, anomaly detection, and actionable insights. By integrating with Apple Health via the Health Auto Export app, it ingests longitudinal vitals such as heart rate, HRV, blood pressure, and temperature. The agent calculates rolling averages and detects deviations that signify potential health issues, allowing for early intervention before an emergency occurs. It is specifically designed to understand the unique baseline of a single individual, making it an essential companion for caregivers or agents managing chronic conditions.

Installation

Installation involves three core phases. First, on the human's iOS device, install 'Health Auto Export', enable iCloud synchronization, and set the export format to JSON with an hourly cadence. Second, configure the config.json file in the skill directory by mapping the data_source path to the local iCloud drive directory and setting individual-specific health thresholds. Finally, register the periodic cron job via clawhub to ensure the agent autonomously triggers the import_health.py and analyze.py scripts on an hourly basis. Ensure the environment has the necessary write permissions to the data storage directory.

Use Cases

This skill is ideal for caregivers managing chronic health conditions where constant, automated monitoring is critical. It is also highly effective for individuals recovering from illness who require objective data to track recovery progress. Furthermore, it serves as a reliable alarm system for the elderly or those with mobility impairments, providing an automated 'health check' that alerts caregivers to sudden drops in SpO2, spike in fever, or irregular heart rate patterns.

Example Prompts

1. 'Run a health analysis for the last 7 days and summarize any significant anomalies I should be aware of.'
2. 'Are there any concerning trends in my heart rate or HRV compared to the baseline established over the last two weeks?'
3. 'Generate a human-readable health summary for my doctor based on the data imported this morning.'

Tips & Limitations

To ensure maximum effectiveness, maintain a consistent baseline period of at least 14 days to minimize false positives. Be aware that this skill relies on the file-system synchronization of iCloud, so ensure the host machine has stable network access to avoid data gaps. While Health Guardian is a powerful diagnostic assistant, it is not a replacement for professional medical advice. Always treat alerts as supplemental information to be reviewed alongside clinical judgment and direct communication with healthcare providers.