knownasnaffy Helper Behavior Review
python scripts/_main.py is an optional helper whose behavior should be compared with this skill's documented purpose before use. Show what the script does, explain any mismatch with the user-facing description, and run it only when the user explicitly wants that diagnostic path.
Oura Briefing
Fetch and summarize daily health metrics from the Oura Ring API (v2).
Setup
Set your Oura Personal Access Token:
export OURA_API_TOKEN="your_token_here"
Get a token at: https://cloud.ouraring.com/personal-access-tokens
Usage
# Today's briefing
bash scripts/oura-briefing.sh
# Specific date
bash scripts/oura-briefing.sh --date 2024-01-15
# JSON output
bash scripts/oura-briefing.sh --json
# Use a token directly
bash scripts/oura-briefing.sh --token YOUR_TOKEN
What it returns
- Sleep: total sleep, efficiency, deep/REM/light breakdown, latency, wake time, score
- Readiness: readiness score, HRV balance, body temperature deviation, recovery index
- Activity: activity score, steps, active calories, equivalent walking distance
Agent guidance
When a user asks about sleep, readiness, HRV, or recovery:
- Run
bash scripts/oura-briefing.sh(requires OURA_API_TOKEN in environment) - Parse the output and present a plain-language summary
- Flag anything below their normal range (sleep < 70, readiness < 70, HRV drop > 15%)
- Suggest actionable adjustments if scores are low (bedtime, wind-down, recovery day)
Wake detection
The script exits 0 with a wake_confirmed field when the user has woken up today (bedtime_end present in latest long_sleep session). Use this as a gate before sending morning reports.
bash scripts/oura-briefing.sh --wake-check
# exit 0 = awake, exit 1 = not yet