Skill Health

Analyze wearable health CSV exports (steps, heart rate, sleep, calories, SpO2, exercise, distance) and produce compact JSON reports for hourly, daily, weekly, monthly, sleep (last 30h) and cross-temporal alerts. Use when running or packaging Skill Health analyses and when explaining output semantics, data quality, or known caveats.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install skill-health

Skill Health

Use

Run analysis scripts from scripts/ with a --data-path (ZIP or folder) or --data-dir (directory holding health_data_*). Each script prints JSON to stdout and can also write a file with --output-dir.

Pass --timezone (IANA, e.g. Europe/Madrid, America/New_York) to interpret naive CSV timestamps correctly before UTC serialization.

Minimal examples:

python scripts/run_sleep.py --data-path data/health_data_latest.zip --output-dir outputs
python scripts/run_daily.py --data-path data/health_data_latest.zip --output-dir outputs
python scripts/run_cross_alerts.py --outputs-dir outputs --output-dir outputs

Notes

Sleep metrics use suffix last_{window_hours}h (default last_30h).
Outputs are compact JSON (time_window uses s/e/r, data_quality uses cov/rel).
Dependencies: Python 3.10+ and pandas.

References

references/overview.md (data schemas, outputs, key decisions)
references/operations.md (execution windows, quality rules)