fru-dev3/ai-ready-life/health-app-oura-ring-api
Claude Code and agent skill by fru-dev3/ai-ready-life
- community
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/health-app-oura-ring-apiSKILL.md
The same SKILL.md was published earlier as fru-dev3/ai-ready-life/health-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
| Metric | Endpoint | Notes | |
|---|---|---|---|
| Sleep score | /sleep | 0–100; composite of efficiency, duration, timing | |
| Total sleep | /sleep | Minutes; convert to hours for display | |
| Deep sleep | /sleep | Minutes per night | |
| REM sleep | /sleep | Minutes per night | |
| Sleep efficiency | /sleep | Percentage of time in bed spent asleep | |
| Sleep latency | /sleep | Minutes to fall asleep | |
| HRV RMSSD | /sleep | Nightly average in milliseconds | |
| Readiness score | /daily_readiness | 0–100; composite recovery metric | |
| Resting heart rate | /daily_readiness | Lowest HR during sleep | |
| Daily steps | /daily_activity | Total steps for the day | |
| Active energy | /daily_activity | Kilocalories burned above BMR | |
| Equivalent walking distance | /daily_activity | km |
Configuration
Add to vault/health/config.md:
To obtain your API key: Oura app → Profile → Personal Access Tokens → Create Token
Key API Calls
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 datahealth-anomaly-watch— flag HRV drops, low readiness streaks, and resting HR elevationhealth-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, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingpaperclip-pkg/skills/health-app-oura-ring.api/SKILL.md
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. Refreshed 12 Oct 2026, a month ago.
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
[](https://verified-skill.com/skills/fru-dev3/ai-ready-life/health-app-oura-ring-api)