← Back to Skills Marketplace
sameerbajaj

Oura Ring

by sameerbajaj · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
1781
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install oura-ring-skill
Description
Fetch Oura Ring readiness/sleep + 7-day readiness trends via Oura Cloud API V2, and generate a Morning Readiness Brief.
Usage Guidance
What to check before installing or running this skill: - Expect to provide an OURA API token (OURA_TOKEN or OURA_PERSONAL_ACCESS_TOKEN). The package metadata did not declare this — that mismatch is likely an oversight. Do not proceed until you understand where your token will be stored (skills/oura-ring/.env is the default) and ensure you don't commit that file to source control. - Inspect and (ideally) remove or sanitize the probe_v2.py and probe_v2_sessions.py files. They reference a hard-coded developer path (/Users/sameerbajaj/...) and load a token from that location; that looks like leftover developer/debug code. If you do not need them, delete them to avoid accidental execution or accidental use of a local .env. - Confirm dependencies before running: requirements.txt lists requests and python-dotenv, but the probe scripts use httpx. If you run probes, install httpx separately or avoid running them. - Run the CLI in an isolated environment (virtualenv) as suggested and review the .env contents. Consider creating a least-privilege Oura API app/token rather than using broad personal tokens. - If you will allow an autonomous agent to call this skill, be aware it can access the Oura token you supply; ensure the agent's authorization scope and the token’s scope are limited to what you intend. If the registry entry is meant to be public, ask the skill owner to update the manifest to declare the required environment variable(s) and to remove or document the probe scripts and any hard-coded paths. If you are unsure about the probe files or hidden behavior, prefer not to install or run the skill until the author clarifies.
Capability Analysis
Type: OpenClaw Skill Name: oura-ring-skill Version: 0.1.0 The skill is generally benign, fetching Oura Ring data via its API. However, the `probe_v2.py` and `probe_v2_sessions.py` files contain hardcoded paths to the `.env` file (`/Users/sameerbajaj/clawd/skills/oura-ring/.env`). While these are likely debug scripts and the path points to the skill's own configuration, hardcoding paths to files that contain secrets is a risky practice and could lead to issues in different environments or accidental information exposure, classifying it as suspicious rather than benign.
Capability Assessment
Purpose & Capability
The skill's description (fetch Oura readiness/sleep/trends and produce a morning brief) matches the CLI and shell wrapper. However the registry metadata declares no required environment variables or primary credential, while the code and README clearly require an OURA token (OURA_TOKEN or OURA_PERSONAL_ACCESS_TOKEN). That mismatch between declared requirements and actual needs is a red flag.
Instruction Scope
SKILL.md instructions are scoped to obtaining an OAuth token, creating a .env, installing dependencies in a venv, and running the CLI or the morning_brief script — all appropriate for this purpose. However there are additional 'probe' scripts (probe_v2.py, probe_v2_sessions.py) that are not documented in SKILL.md and which load a .env from an absolute developer path; those files expand the code footprint beyond the documented runtime and should be reviewed/removed if not needed.
Install Mechanism
There is no install spec (instruction-only style), which is low risk. The provided requirements.txt only lists requests and python-dotenv, while the probe scripts reference httpx — an inconsistency in declared dependencies. No remote or obscure download/install steps are present.
Credentials
The skill needs a sensitive bearer token to call the Oura API (OURA_TOKEN or OURA_PERSONAL_ACCESS_TOKEN), but the registry metadata does not declare these required env vars or a primary credential. The probe files also reference an absolute local path and a personal access token variable name, increasing the risk of accidentally using or exposing the wrong credential. Requiring a single Oura OAuth token is reasonable for the stated purpose, but the omission from metadata and the extra token names/path warrant caution.
Persistence & Privilege
The skill does not request persistent or elevated platform privileges and 'always' is false. It does not modify other skills or global agent configuration. The CLI and script run on demand and use a local .env; autonomous invocation remains possible (platform default) but not combined here with other high-risk flags.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install oura-ring-skill
  3. After installation, invoke the skill by name or use /oura-ring-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of oura-ring-skill. - Fetches Oura Ring Readiness, Sleep data, and 7-day readiness trends via Oura Cloud API V2. - Provides a formatted Morning Readiness Brief with tactical recommendations. - Includes trend analysis and resilience tracking features. - Command-line utilities support raw data output and formatted briefs. - Supports mock mode and easy .env configuration for fast setup and testing.
Metadata
Slug oura-ring-skill
Version 0.1.0
License
All-time Installs 2
Active Installs 2
Total Versions 1
Frequently Asked Questions

What is Oura Ring?

Fetch Oura Ring readiness/sleep + 7-day readiness trends via Oura Cloud API V2, and generate a Morning Readiness Brief. It is an AI Agent Skill for Claude Code / OpenClaw, with 1781 downloads so far.

How do I install Oura Ring?

Run "/install oura-ring-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Oura Ring free?

Yes, Oura Ring is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Oura Ring support?

Oura Ring is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Oura Ring?

It is built and maintained by sameerbajaj (@sameerbajaj); the current version is v0.1.0.

💬 Comments