oura-analytics
by kesslerio
Health & FitnessBrief
Oura Ring data integration and analytics.
Description
What This Skill Does
Fetches and analyzes data from the Oura Ring via the Oura Cloud API, including sleep scores, readiness, activity, and HRV. Supports trend analysis, automated report generation, and threshold-based alerts for low recovery days.
Automates data extraction and analysis that would otherwise require manual checks in the Oura app, enabling scheduled reports and programmatic alerts without opening a UI.
When to Use It
- Checking sleep score trends over the past month
- Getting a readiness alert before a high-stakes day
- Generating a weekly HRV report to track training load
- Correlating poor sleep nights with calendar events
- Setting a morning briefing with yesterday's recovery metrics
Example Workflow
User asks: generate my weekly sleep and readiness report
- 1
Set OURA_API_TOKEN from environment
- 2
Call oura_api.py with report --type weekly flag
- 3
Fetch sleep and readiness data for the past 7 days via OuraClient
- 4
Run OuraAnalyzer to compute average scores and HRV trend
- 5
Output a formatted weekly summary
Weekly report showing average sleep score, readiness score, HRV trend, and notable low-recovery days
Requirements
- OURA_API_TOKEN environment variable (get at cloud.ouraring.com)
Installation
clawhub install kesslerio/oura-analyticsRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.