← Back to Skills Marketplace
WHOOP Health
by
JIAWEI YIN
· GitHub ↗
· v1.0.0
· MIT-0
223
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install whoop-health
Description
Fetch, analyze, and visualize WHOOP wearable health data via the WHOOP Developer API v2. Use when the user wants to connect their WHOOP band, retrieve recove...
Usage Guidance
This skill appears to do what it says: perform OAuth against WHOOP and fetch health data. Before installing or running it: 1) Verify the WHOOP client_id and client_secret come from your WHOOP developer app (the scripts accept these via flags or WHOOP_CLIENT_ID/WHOOP_CLIENT_SECRET env vars). 2) Note the skill saves tokens to ~/.whoop_tokens.json (with 0600 perms) — protect this file and delete/revoke tokens when finished (whoop_auth.py --revoke). 3) The SKILL.md mentions API v2 but the code uses v1 endpoints; confirm the endpoints/versions match the WHOOP API you expect. 4) The auth flow spins up a localhost server on port 8080 for the OAuth redirect — ensure that port is acceptable to use. 5) Review the included scripts yourself (they are small and use only the Python standard library) before running, especially since this handles sensitive health data. If you need the registry metadata corrected (declare the token file path and optional env vars), ask the skill author to update those fields.
Capability Analysis
Type: OpenClaw Skill
Name: whoop-health
Version: 1.0.0
The skill bundle provides a legitimate integration with the WHOOP Developer API for health data retrieval and analysis. It implements a standard OAuth 2.0 flow in `scripts/whoop_auth.py`, securely stores tokens locally with restricted file permissions (0o600), and uses well-defined API endpoints in `scripts/whoop_fetch.py` without any evidence of data exfiltration, obfuscation, or malicious execution.
Capability Assessment
Purpose & Capability
The skill's name and description (WHOOP API integration) align with the included Python auth and fetch scripts. Minor inconsistencies: the SKILL.md text mentions WHOOP Developer API v2 while the code and references use v1 endpoints (/developer/v1). The registry metadata declares no required config paths/env vars, but the skill expects and uses tokens at ~/.whoop_tokens.json and optionally WHOOP_CLIENT_ID / WHOOP_CLIENT_SECRET.
Instruction Scope
Runtime instructions are scoped to creating a WHOOP developer app, running the included OAuth helper to obtain tokens, and fetching WHOOP data. The instructions only tell the agent to read/write the token file (~/.whoop_tokens.json) and output JSON/CSV files. No steps ask the agent to read unrelated system files or send data to unexpected external endpoints.
Install Mechanism
This is an instruction-only skill with bundled Python scripts; there is no install spec or network download of arbitrary code. The scripts are plain Python and import only standard library modules.
Credentials
The skill does not require any unrelated credentials. It optionally reads WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET (declared in SKILL.md but not as required in the registry), and it stores tokens in ~/.whoop_tokens.json. The manifest should have declared that config path and the optional env vars; their use is otherwise appropriate for OAuth token refresh and API access.
Persistence & Privilege
The skill writes and reads a token file (~/.whoop_tokens.json) in the user's home directory and sets restrictive file permissions (0o600). always:false (no forced presence). The token file is expected behavior for an OAuth flow, but you should be aware that the token file contains access/refresh tokens stored locally.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install whoop-health - After installation, invoke the skill by name or use
/whoop-health - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: OAuth auth flow, data fetcher for recovery/sleep/workout/cycle, WHOOP API v1 reference
Metadata
Frequently Asked Questions
What is WHOOP Health?
Fetch, analyze, and visualize WHOOP wearable health data via the WHOOP Developer API v2. Use when the user wants to connect their WHOOP band, retrieve recove... It is an AI Agent Skill for Claude Code / OpenClaw, with 223 downloads so far.
How do I install WHOOP Health?
Run "/install whoop-health" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is WHOOP Health free?
Yes, WHOOP Health is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does WHOOP Health support?
WHOOP Health is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created WHOOP Health?
It is built and maintained by JIAWEI YIN (@jarviyin); the current version is v1.0.0.
More Skills