Skill Health

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:

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)