montagao/skills1 file

Ouraclaw

Fetch Oura Ring sleep data using the ouraclaw CLI. Use when the user asks about their sleep score, sleep data, sleep stages, HRV, heart rate during sleep, bedtimes, or any Oura Ring data. Triggers on "sleep score", "how did I sleep", "oura data", "sleep data", "last night's sleep", "sleep quality", "HRV", or any request for Oura Ring metrics.

Specification
Skill ID
montagao/skills/ouraclaw
Publisher
montagao
Repository
skills
Installs
0
Files
1
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

montagao/skills/ouraclawInstalls these files
  • SKILL.md

What this skill tells the agent

Ouraclaw

Fetch Oura Ring sleep data via the ouraclaw CLI. Outputs JSON to stdout.

Ensure ouraclaw is installed

which ouraclaw

If not found:

git clone https://github.com/montagao/ouraclaw.git ~/projects/ouraclaw
cd ~/projects/ouraclaw && bun install && bun link

If auth is needed (no tokens in .env), run cd ~/projects/ouraclaw && ouraclaw auth.

Commands

# Last night's sleep score
ouraclaw score

# Date range
ouraclaw score --start 2025-02-01 --end 2025-02-15

# Detailed sleep sessions (stages, HR, HRV, bedtimes)
ouraclaw sleep

# Date range
ouraclaw sleep --start 2025-02-01 --end 2025-02-15

Extracting fields with jq

ouraclaw score | jq '.data[0].score'
ouraclaw sleep | jq '.data[0] | {bedtime_start, bedtime_end}'
ouraclaw score --start 2025-02-01 --end 2025-02-15 | jq '[.data[] | {day, score}]'

Error handling

  • "No access token": Run cd ~/projects/ouraclaw && ouraclaw auth.
  • 401 after auto-refresh fails: Re-run ouraclaw auth.

Use this skill in a project

Open any RiverX project, search the Skills panel for montagao/skills/ouraclaw, and install it in one click.

Use this skill