Agent skill

Oura Setup

by vellum-ai in vellum-ai/vellum-assistant

Connect an Oura Ring via OAuth2 — app registration, token exchange, and credential storage

Install Oura Setup

skills CLI

$ npx skills add vellum-ai/vellum-assistant --skill oura-setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install vellum-ai/vellum-assistant oura-setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/oura-setup .claude/skills/oura-setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "oura-setup" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/oura-setup into .claude/skills/oura-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oura-setup", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/vellum-ai/vellum-assistant/tree/main/skills/oura-setup

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add vellum-ai/vellum-assistant --skill oura-setup -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install vellum-ai/vellum-assistant oura-setup --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/oura-setup .agents/skills/oura-setup && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "oura-setup" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/oura-setup into .agents/skills/oura-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oura-setup", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add vellum-ai/vellum-assistant --skill oura-setup -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install vellum-ai/vellum-assistant oura-setup --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/oura-setup .cursor/skills/oura-setup && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "oura-setup" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/oura-setup into .cursor/skills/oura-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oura-setup", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/vellum-ai/vellum-assistant.git --path skills/oura-setup

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add vellum-ai/vellum-assistant --skill oura-setup -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install vellum-ai/vellum-assistant oura-setup --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/oura-setup .gemini/skills/oura-setup && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "oura-setup" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/oura-setup into .gemini/skills/oura-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oura-setup", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install vellum-ai/vellum-assistant oura-setup

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add vellum-ai/vellum-assistant --skill oura-setup -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/oura-setup .github/skills/oura-setup && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "oura-setup" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/oura-setup into .github/skills/oura-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oura-setup", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add vellum-ai/vellum-assistant --skill oura-setup -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install vellum-ai/vellum-assistant oura-setup --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/oura-setup .opencode/skills/oura-setup && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "oura-setup" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/oura-setup into .opencode/skills/oura-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oura-setup", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: oura-setup
GitHub stars: 1.4k
Token cost: ~1.9k tokens
SKILL.md length: 466 words
Files: 1
Skills in repo: 108
Repo updated: Oct 9, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Connect an Oura Ring via OAuth2 — app registration, token exchange, and credential storage

Works in 4 steps: Register a Developer Application → Run the OAuth Flow → Store Tokens → …
Tasks that involve OAuth and OpenID Connect
SKILL.md covers Prerequisites, Setup, Available Endpoints and Token Refresh, plus 1 more section
Calls curl and python3; reaches api.ouraring.com and cloud.ouraring.com; needs CLIENT_SECRET and REFRESH_TOKEN

What it does

Oura Setup is an agent skill from vellum-ai/vellum-assistant. Connect an Oura Ring via OAuth2 — app registration, token exchange, and credential storage

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for Vellum personal assistants

It sits in Backend & APIs, covering OAuth and OpenID Connect. The repository describes itself as: An AI Assistant that’s easy to setup, does your work 24/7, knows your preferences and gets better over time. The licence is MIT.

When your agent uses it

Tasks that involve OAuth and OpenID Connect

Example prompts

“/oura-setup”

Requirements

Python 3
A credential in CLIENT_SECRET
A credential in YOUR_CLIENT_SECRET
Compatibility (from SKILL.md): Designed for Vellum personal assistants

Workflow steps

4 steps, taken from the step headings in SKILL.md.

Register a Developer Application
Run the OAuth Flow
Store Tokens
Verify Connection

What it can do on your machine

Read from SKILL.md and the folder at commit 33cc983. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- curl
- python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- api.ouraring.com
- cloud.ouraring.com
Also links to:
- developer.ouraring.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- CLIENT_SECRET
- REFRESH_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Designed for Vellum personal assistants
From compatibility in the SKILL.md frontmatter.

Context cost

Oura Setup loads about 1.9k tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 466 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~25
When it runs · the whole SKILL.md, loaded when a task matches: ~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from vellum-ai/vellum-assistant at commit 33cc983, republished under its MIT licence (© vellum-ai). 466 words, ~1,910 tokens.

Download SKILL.mdSave it as .claude/skills/oura-setup/SKILL.md (or your agent's skills folder).

name: oura-setup
description: Connect an Oura Ring via OAuth2 — app registration, token exchange, and credential storage
compatibility: Designed for Vellum personal assistants
metadata.emoji: 💍

Oura Ring Integration

Connect the user's Oura Ring to pull sleep, heart rate, readiness, activity, and other health data via the Oura Cloud API V2.

Prerequisites

An Oura Ring (Gen 3 or Ring 4) with an active Oura Membership ($6/mo required for API access)
The Oura app installed and paired with the ring
An Oura Cloud account at https://cloud.ouraring.com

Setup

1. Register a Developer Application

Have the user go to https://developer.ouraring.com/applications and create a new application:

Display Name: The user's preferred name for the integration
Description: Brief description of the integration
Contact Email: User's email
Website: Any valid URL (e.g. a personal website)
Privacy Policy / Terms of Service: Any valid URLs (required fields, not enforced for personal apps)
Redirect URIs: http://localhost:3000/callback
Scopes: Enable all scopes needed. Recommended: personal, daily, heartrate, sleep, workout, spo2, stress, heart_health, session, ring_configuration

Save the Client ID and Client Secret.

2. Run the OAuth Flow

Store the client secret securely using assistant credentials prompt, then write and run the OAuth helper script on the user's machine:

python

#!/usr/bin/env python3
"""Oura Ring OAuth2 helper — catches auth code and exchanges for tokens instantly."""
from http.server import HTTPServer, BaseHTTPRequestHandler
from urllib.parse import urlparse, parse_qs, urlencode
import urllib.request, json, webbrowser, ssl

CLIENT_ID = 'YOUR_CLIENT_ID'
CLIENT_SECRET = 'YOUR_CLIENT_SECRET'
REDIRECT_URI = 'http://localhost:3000/callback'
SCOPES = 'email personal daily heartrate workout tag session spo2 ring_configuration stress heart_health'

class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        parsed = urlparse(self.path)
        if parsed.path == '/':
            params = urlencode({
                'response_type': 'code', 'client_id': CLIENT_ID,
                'redirect_uri': REDIRECT_URI, 'scope': SCOPES, 'state': 'assistant'
            })
            self.send_response(302)
            self.send_header('Location', f'https://cloud.ouraring.com/oauth/authorize?{params}')
            self.end_headers()
        elif parsed.path == '/callback':
            code = parse_qs(parsed.query).get('code', [''])[0]
            if code:
                token_data = urlencode({
                    'grant_type': 'authorization_code', 'code': code,
                    'redirect_uri': REDIRECT_URI, 'client_id': CLIENT_ID,
                    'client_secret': CLIENT_SECRET,
                }).encode()
                try:
                    req = urllib.request.Request('https://api.ouraring.com/oauth/token',
                        data=token_data,
                        headers={'Content-Type': 'application/x-www-form-urlencoded'},
                        method='POST')
                    resp = urllib.request.urlopen(req, context=ssl.create_default_context())
                    result = json.loads(resp.read())
                    with open('/tmp/oura_tokens.json', 'w') as f:
                        json.dump(result, f, indent=2)
                    self.send_response(200)
                    self.send_header('Content-Type', 'text/html')
                    self.end_headers()
                    self.wfile.write(b'<html><body><h1>Connected! You can close this tab.</h1></body></html>')
                    print(f'\nTokens saved to /tmp/oura_tokens.json')
                except Exception as e:
                    self.send_response(500)
                    self.end_headers()
                    self.wfile.write(f'Token exchange failed: {e}'.encode())
    def log_message(self, *a): pass

print('Opening browser for Oura authorization...')
webbrowser.open('http://localhost:3000')
HTTPServer(('localhost', 3000), Handler).serve_forever()

Run with python3 /path/to/script.py on the user's machine (host_bash). The user authorizes in their browser, the script catches the code and exchanges it for tokens in under a second.

Important: Auth codes expire in ~30 seconds. Do NOT have the user paste codes manually — use this script to catch and exchange them automatically.

3. Store Tokens

After the OAuth flow, read tokens from /tmp/oura_tokens.json and store them:

access_token — store in credential vault with injection template for api.ouraring.com Authorization header (Bearer prefix) and allowed_tools: ["bash"]
refresh_token — store in credential vault for token refresh
Tokens expire in ~30 days. Set a reminder to refresh before expiry.

4. Verify Connection

Test with the personal info endpoint:

bash

curl -s -H "Authorization: Bearer $TOKEN" "https://api.ouraring.com/v2/usercollection/personal_info"

Show full SKILL.md (183 more words)Show less

Available Endpoints

All endpoints use GET https://api.ouraring.com/v2/usercollection/{type} with query params start_date and end_date (YYYY-MM-DD format).

Endpoint	Data	Notes
`/v2/usercollection/daily_sleep`	Sleep score, duration, efficiency, stages	Best checked after user's typical wake time
`/v2/usercollection/sleep`	Detailed sleep periods with HR, HRV, movement	Raw sleep period data
`/v2/usercollection/daily_readiness`	Readiness score, HRV balance, recovery	Good morning check-in metric
`/v2/usercollection/daily_activity`	Steps, calories, movement, inactivity	Activity summary
`/v2/usercollection/heartrate`	Continuous HR (use `start_datetime`/`end_datetime` in ISO format)	Can be large — limit date range
`/v2/usercollection/daily_spo2`	Blood oxygen levels	Nightly average
`/v2/usercollection/daily_stress`	Stress score and recovery	Daytime stress tracking
`/v2/usercollection/workout`	Detected workouts with HR, calories	Auto-detected or manual
`/v2/usercollection/personal_info`	Age, weight, height, email	Good connection test

Token Refresh

Tokens expire after 30 days. Refresh with:

bash

curl -s -X POST "https://api.ouraring.com/oauth/token" \
  -d "grant_type=refresh_token&refresh_token=$REFRESH_TOKEN&client_id=$CLIENT_ID&client_secret=$CLIENT_SECRET"

Store the new access_token and refresh_token from the response.

Tips

New rings need 1-2 nights to calibrate before data is meaningful
Sleep data typically appears a few hours after the user wakes up
Heart rate data during workouts appears after the workout syncs via the Oura app
Rate limit: 5000 requests per 5 minutes
Ring 4 and Gen 3 users MUST have an active Oura Membership for API access

Files

Just SKILL.md in skills/oura-setup of vellum-ai/vellum-assistant.

Open the folder on GitHubat commit 33cc983

Compare with similar skills

Oura Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Oura Setup compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Oura Setup this skillvellum-ai/vellum-assistant	1.4k	—	~1.9k	Automated safety check: Pass	MIT	yesterday
Fortify Developmentcoollabsio/coolify	63k	4 repos	~1.9k	Automated safety check: Pass	MIT	today
OmniRoute Provider Managementdiegosouzapw/OmniRoute	75k	—	~2.4k	Automated safety check: Pass	MIT	today
Antipattern Preventiondoorkeeper-gem/doorkeeper	5.5k	—	~1.1k	Automated safety check: Pass	MIT	yesterday
Cognitoitsmostafa/aws-agent-skills	1.2k	1 repos	~2.3k	Automated safety check: Pass	MIT	4 days ago
Notion Worker Third-Party Auth Guidemakenotion/workers-template	439	1 repos	~3.5k	Automated safety check: Notes	MIT	28 days ago

Similar skills

Fortify Development
coollabsio/coolify
ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.
63k GitHub starsUsed in 4 repos~1.9k tokens
Backend & APIsAuto-check passed
OmniRoute Provider Management
diegosouzapw/OmniRoute
Manages AI provider connections, API keys, OAuth flows and connection tests through OmniRoute's REST API across its 327-provider catalog.
75k GitHub stars~2.4k tokensUpdated today
Backend & APIsAuto-check passed
Antipattern Prevention
doorkeeper-gem/doorkeeper
Avoid common Ruby and Rails antipatterns that degrade maintainability and performance.
5.5k GitHub stars~1.1k tokensUpdated yesterday
Backend & APIsAuto-check passed
Cognito
itsmostafa/aws-agent-skills
AWS Cognito user authentication and authorization service. An agent skill from itsmostafa/aws-agent-skills.
1.2k GitHub starsUsed in 1 repo~2.3k tokens
Backend & APIsAuto-check passed
Notion Worker Third-Party Auth Guide
makenotion/workers-template
Official
Decides whether a Notion Worker should use a brokered credential, a plaintext environment secret, or OAuth to authenticate against a non-Notion service.
439 GitHub starsUsed in 1 repo~3.5k tokens
Backend & APIsAuto-check: notes
Stripe Best Practices
kanchengw/cnllm
Guides Stripe integration decisions — API selection (Checkout Sessions vs PaymentIntents), Connect platform setup (Accounts v2, controller properties), billing/subscriptions, Treasury financial…
173 GitHub starsUsed in 2 repos~925 tokens
Backend & APIsAuto-check passed

Questions about Oura Setup

What does Oura Setup do?

Connect an Oura Ring via OAuth2 — app registration, token exchange, and credential storage. Oura Setup is an agent skill from vellum-ai/vellum-assistant.

When should I use Oura Setup?

Oura Setup fits situations like: tasks that involve OAuth and OpenID Connect.

How do I install Oura Setup in Claude Code?

Run `npx skills add vellum-ai/vellum-assistant --skill oura-setup -a claude-code`. Or copy the skill folder (skills/oura-setup in vellum-ai/vellum-assistant) into .claude/skills/oura-setup in your project. Claude Code loads it when a task matches its description.

How do I install Oura Setup in Codex?

Run `npx skills add vellum-ai/vellum-assistant --skill oura-setup -a codex`. Or copy the skill folder (skills/oura-setup in vellum-ai/vellum-assistant) into .agents/skills/oura-setup in your project. Codex loads it when a task matches its description.

Can I use Oura Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vellum-ai/vellum-assistant --skill oura-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/oura-setup, .gemini/skills/oura-setup, .github/skills/oura-setup and .opencode/skills/oura-setup in your project.

What does Oura Setup need to run?

Going by SKILL.md and its folder, Oura Setup needs the command-line tools its instructions call (curl and python3) and credentials named CLIENT_SECRET and REFRESH_TOKEN. Our summary lists: Python 3; A credential in CLIENT_SECRET; A credential in YOUR_CLIENT_SECRET. Compatibility (from SKILL.md): Designed for Vellum personal assistants.

Does Oura Setup access the network?

SKILL.md names 3 domains. In commands or code: api.ouraring.com and cloud.ouraring.com; the agent is likely to contact these when it follows the instructions. As links in the text: developer.ouraring.com. This is read from the text; nothing was executed.

Is Oura Setup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Oura Setup use?

Oura Setup is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Oura Setup use?

About 1.9k tokens (SKILL.md is roughly 7.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Oura Setup?

Skills that share tags, products or a category with Oura Setup: Fortify Development (coollabsio/coolify, 63k stars), OmniRoute Provider Management (diegosouzapw/OmniRoute, 75k stars), Antipattern Prevention (doorkeeper-gem/doorkeeper, 5.5k stars) and Cognito (itsmostafa/aws-agent-skills, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Oura Setup?

vellum-ai (a GitHub organization) maintains it in vellum-ai/vellum-assistant, which has 1,408 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on October 9, 2026.

Source: vellum-ai/vellum-assistant on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Oura Setup

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Compatibility

Context cost

Safety

SKILL.md

Oura Ring Integration

Prerequisites

Setup

1. Register a Developer Application

2. Run the OAuth Flow

3. Store Tokens

4. Verify Connection

Available Endpoints

Token Refresh

Tips

Files

Compare with similar skills

Similar skills

More from vellum-ai/vellum-assistant

Related

Questions about Oura Setup