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

---





### Permission Setup Review

`python scripts/_tool_policy_note.py` is an optional setup helper for the `Skill Health` skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.

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

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