rickybloomfield/ouraclaw

Overview

This skill connects to a user's Oura Ring data to surface sleep, readiness, activity, and stress insights. It pulls daily and detailed endpoints to produce scannable summaries, scheduled morning/evening recaps, and ad-hoc answers. The focus is concise, actionable health data formatted for the target messaging channel.

How this skill works

The skill calls Oura endpoints (daily_sleep, daily_readiness, daily_activity, sleep, daily_stress, and more) to assemble scores, contributors, and raw metrics. It converts durations from seconds to hours/minutes, handles missing/null fields gracefully, and formats output per the requested delivery channel. For comprehensive questions it aggregates multiple endpoints and provides trend summaries across date ranges.

When to use it

• Get a quick morning or evening health recap tailored to your messaging app
• Ask "How did I sleep?" to receive score plus detailed sleep-stage durations and overnight vitals
• Check readiness before training or a busy day (HRV, resting HR, recovery index)
• Monitor daily activity: steps, active calories, and activity score
• Request stress or resilience summaries and mindfulness session details
• Compare sleep or activity trends over a week or custom date ranges

Best practices

• Request a channel (plain, WhatsApp, Slack, Discord, Telegram) so output uses correct formatting
• Leave dates blank for today's data or provide start_date/end_date (YYYY-MM-DD) for ranges
• When asking about sleep include both ‘daily_sleep’ and ‘sleep’ for score plus period details
• Expect durations in seconds from the API — the skill returns them as Xh Ym for readability
• If a field is null the skill notes it gently instead of showing raw null values

Example use cases

• Morning summary: consolidated sleep, readiness, activity, and stress with two-line highlights
• Evening summary: today's activity, readiness, stress, and a one-line recap of last night's sleep
• Ad-hoc: "Am I ready to work out today?" — returns readiness score and main contributors
• Trend report: "Show last week's sleep trends" — 7-day averages and whether sleep is improving
• Deep-dive: Pull detailed heart rate or workout sessions for coaching or recovery planning