fru-dev3/ai-ready-life/app-oura-ring-api

Claude Code and agent skill by fru-dev3/ai-ready-life

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Fetches daily sleep, readiness, and activity data from the Oura Ring API v2 using a personal API key. Returns sleep score, total sleep duration, deep/REM/light sleep stages, HRV RMSSD (nightly), resting heart rate, readiness score (0-100), steps, and active calories. Owns dedup and append into vault/health/00_current/wearable-log.csv: every fetch checks each incoming day's date against existing rows and appends only records not already present. Used by the health agent for wearable data sync, 90-day baseline trend analysis, and anomaly detection. Configure API key in vault/health/config.md.

Install

npx vskill@latest install fru-dev3/ai-ready-life/app-oura-ring-api

SKILL.md

The same SKILL.md was published earlier as fru-dev3/ai-ready-life/app-oura-ring-api.

Oura Ring

Auth: API key (oura_api_key in config.md) Base URL: https://api.ouraring.com/v2/usercollection/ Documentation: https://cloud.ouraring.com/v2/docs

Data Available

MetricEndpointNotes
Sleep score/sleep0–100; composite of efficiency, duration, timing
Total sleep/sleepMinutes; convert to hours for display
Deep sleep/sleepMinutes per night
REM sleep/sleepMinutes per night
Sleep efficiency/sleepPercentage of time in bed spent asleep
Sleep latency/sleepMinutes to fall asleep
HRV RMSSD/sleepNightly average in milliseconds
Readiness score/daily_readiness0–100; composite recovery metric
Resting heart rate/daily_readinessLowest HR during sleep
Daily steps/daily_activityTotal steps for the day
Active energy/daily_activityKilocalories burned above BMR
Equivalent walking distance/daily_activitykm

Configuration

Add to vault/health/config.md:

oura_api_key: YOUR_OURA_API_KEY
oura_lookback_days: 90

To obtain your API key: Oura app → Profile → Personal Access Tokens → Create Token

Key API Calls

# Sleep data
GET https://api.ouraring.com/v2/usercollection/sleep?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD
Authorization: Bearer {oura_api_key}
# Readiness data (includes resting HR)
GET https://api.ouraring.com/v2/usercollection/daily_readiness?start_date=YYYY-MM-DD
Authorization: Bearer {oura_api_key}
# Activity data (steps, active energy)
GET https://api.ouraring.com/v2/usercollection/daily_activity?start_date=YYYY-MM-DD
Authorization: Bearer {oura_api_key}

Rate Limits

Oura API v2: 5,000 requests/day per token. The health agent's monthly sync requests approximately 3 API calls per sync (one per endpoint). Well within limits.

Used By

  • health-sync-wearable-data — pull nightly sleep, readiness, and activity data
  • health-anomaly-watch — flag HRV drops, low readiness streaks, and resting HR elevation
  • health-build-wellness-summary — provide data for 30-day and 90-day trend calculations

Vault Output

  • vault/health/00_current/wearable-log.csv — daily records appended from API response

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
17
Repository forks
5
7-day trend score
19

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/fru-dev3/ai-ready-life/app-oura-ring-api/badge)](https://verified-skill.com/skills/fru-dev3/ai-ready-life/app-oura-ring-api)

Something wrong with this skill or its page? Tell us.