{"skill":{"slug":"oura-health","displayName":"Oura Health","summary":"What: Query Oura Ring health data — sleep, readiness, activity, heart rate, and trends via the Oura API v2. When: User asks about their sleep, readiness, act...","description":"---\nname: oura-ring\ndescription: |\n  What: Query Oura Ring health data — sleep, readiness, activity, heart rate, and trends via the Oura API v2.\n  When: User asks about their sleep, readiness, activity, heart rate, health trends, or wants a daily health briefing.\n  Triggers: oura, sleep score, readiness, activity score, heart rate, HRV, health briefing, ring data\nversion: 1.0.0\nlicense: MIT\n---\n\n# Oura Ring Skill\n\nQuery Oura Ring health data via the Oura API v2. Requires a personal access token at `~/.config/oura/credentials.json`.\n\n## Setup\n\n```json\n// ~/.config/oura/credentials.json\n{\"personal_access_token\": \"YOUR_TOKEN\", \"base_url\": \"https://api.ouraring.com/v2\"}\n```\n\nGet your token at https://cloud.ouraring.com/personal-access-tokens\n\n## Commands\n\nAll commands use: `/opt/homebrew/bin/python3.11 <skill_dir>/scripts/oura_api.py <command> [args]`\n\n### `status`\nConnection test + personal info (age, email, biological sex).\n\n### `briefing`\nToday's combined readiness + sleep + activity summary. Best for morning check-ins.\n\n### `sleep [YYYY-MM-DD]`\nDetailed sleep data: duration, stages, efficiency, HRV, temperature. Defaults to last night.\n\n### `readiness [YYYY-MM-DD]`\nReadiness score with all contributors (HRV balance, body temp, recovery, sleep, activity). Defaults to today.\n\n### `activity [YYYY-MM-DD]`\nActivity details: steps, calories, active time, movement breakdown. Defaults to today.\n\n### `heartrate [hours]`\nRecent heart rate statistics (min, max, avg, latest). Default: last 4 hours.\n\n### `trends [days]`\nMulti-day trend view of readiness, sleep, and activity scores. Default: 7 days.\n\n## Health Alerts\n\nStandalone alert checker for heartbeats/crons:\n\n```\n/opt/homebrew/bin/python3.11 <skill_dir>/scripts/health_alerts.py\n```\n\nOutputs one line per alert. Empty output = nothing notable. Exit code 0 always.\n\nChecks:\n- Readiness < 70\n- Sleep < 6 hours\n- HRV trending down 3+ days\n- Resting HR spike > 5bpm above 7-day average\n- Body temperature deviation > 0.5°C\n- Recovery index < 30\n\n## Output Format\n\nAll output is human-readable text with emoji indicators:\n- 🟢 Good (score ≥ 85)\n- 🟡 Fair (score 70–84)\n- 🔴 Needs attention (score < 70)\n\n## Error Handling\n\n- Exit code 0: success\n- Exit code 1: error (message on stderr)\n- Common errors: missing credentials file, invalid token, no data for date\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":600,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773062830908,"updatedAt":1778491788483},"latestVersion":{"version":"1.0.0","createdAt":1773062830908,"changelog":"Initial release: 7 commands (status, briefing, sleep, readiness, activity, heartrate, trends), health alerts checker, stdlib-only Python, zero dependencies. First wearable health skill for OpenClaw.","license":"MIT-0"},"metadata":null,"owner":{"handle":"jarvis563","userId":"s17c02rxwhw8sdc0f5mfvyb945884kpq","displayName":"jarvis563","image":"https://avatars.githubusercontent.com/u/258515214?v=4"},"moderation":null}