skill CX Codex

ouraclaw — Claude Code skill: what it does, how to install

Q: How do I install ouraclaw in Claude Code?

Run `npx skills add montagao/skills --skill ouraclaw -a claude-code`. You also need the `ouraclaw` repository cloned to `~/projects/ouraclaw` and linked using Bun.

Q: How to fix a 401 error or missing access token?

Navigate into `~/projects/ouraclaw` and execute `ouraclaw auth`. This refreshes expired tokens or writes new credentials into `.env`.

Fetches Oura Ring sleep metrics and HRV using a local CLI tool. It helps you inspect sleep scores and sleep stages directly inside agent sessions.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add montagao/skills --skill ouraclaw -a claude-code

Open on GitHub

What ouraclaw does

This skill instructs the agent on how to call the ouraclaw command-line utility. The CLI prints raw JSON directly to stdout. The assistant reads sleep scores and bedtime intervals. It also pulls resting heart rate and heart rate variability metrics without extra wrappers.

Commands split into two paths. Running ouraclaw score fetches aggregate scores for last night or an explicit date window. Detailed sleep stages and timestamps require ouraclaw sleep. Specific attributes can be extracted via jq filters.

The tool depends on a local clone linked through Bun. Without running ouraclaw auth to store credentials in .env, the binary halts with a 401 error.

What it helps with

retrieve sleep scores for last night or date ranges
inspect bedtime timestamps and sleep stages
pull resting heart rate and HRV numbers in JSON
filter Oura Ring metrics using jq

Example prompts for the agent

How did I sleep last night according to my Oura Ring?
Check my sleep score between 2025-02-01 and 2025-02-15
Show my HRV and sleep stages from the last session

How to install ouraclaw

1Skills CLI (Vercel)

npx skills add montagao/skills --skill ouraclaw -a claude-code

2Manually: put the files in place

~/.claude/skills/ouraclaw/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ouraclaw/

1Skills CLI (Vercel)

npx skills add montagao/skills --skill ouraclaw -a codex

2Manually: put the files in place

.agents/skills/ouraclaw/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add montagao/skills --skill ouraclaw -a cursor

2Manually: put the files in place

.cursor/skills/ouraclaw/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install montagao/skills ouraclaw

2Manually: put the files in place

.github/skills/ouraclaw/SKILL.md

1Skills CLI (Vercel)

npx skills add montagao/skills --skill ouraclaw -a gemini-cli

2Platform CLI

gemini skills install https://github.com/montagao/skills --path ouraclaw

Manually: put the files in place

.devin/skills/ouraclaw/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add montagao/skills --skill ouraclaw -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about ouraclaw

How do I install ouraclaw in Claude Code?

Run npx skills add montagao/skills --skill ouraclaw -a claude-code. You also need the ouraclaw repository cloned to ~/projects/ouraclaw and linked using Bun.

What does the ouraclaw skill do?

It gives your AI assistant instructions to pull Oura Ring sleep metrics via a local CLI. The agent can inspect night scores, sleep cycles, heart rate, and HRV.

How to fix a 401 error or missing access token?

Navigate into ~/projects/ouraclaw and execute ouraclaw auth. This refreshes expired tokens or writes new credentials into .env.

find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. CX Codex +1 4,000,000installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. 1,424,476installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. 1,219,756installs handoff Matt Pocock Creates a handoff document from the current conversation so another agent can continue the work. Use it when a task moves to a new session or agent. 1,038,491installs grilling Matt Pocock Stress-test a plan, decision, or idea through structured rounds of questions. Use it when you need to expose assumptions before acting. 979,543installs teach Matt Pocock Turns the current directory into a learning workspace and keeps progress across sessions. Use it when learning needs to support a concrete goal in your project. 862,247installs