# 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.

- Skill: `modbender/skill-health` (Agent Skill, multi-file: 21 files)
- Install (CLI): `npx skillmds@latest add modbender/skill-health`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/skill-health/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/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`.

Minimal examples:

```bash
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)