{"skill":{"slug":"whoop-health-analysis","displayName":"Whoop","summary":"Access Whoop wearable health data (sleep, recovery, strain, HRV, workouts) and generate interactive charts. Use when the user asks about sleep quality, recovery scores, strain levels, HRV trends, workout data, or wants health visualizations/graphs from their Whoop band.","description":"---\nname: whoop\ndescription: Access Whoop wearable health data (sleep, recovery, strain, HRV, workouts) and generate interactive charts. Use when the user asks about sleep quality, recovery scores, strain levels, HRV trends, workout data, or wants health visualizations/graphs from their Whoop band.\n---\n\n# Whoop\n\nQuery health metrics from the Whoop API and generate interactive HTML charts.\n\n## Setup (first time only)\n\n### 1. Create a Whoop Developer App\n\n1. Go to [developer-dashboard.whoop.com](https://developer-dashboard.whoop.com)\n2. Sign in with your Whoop account credentials\n3. Create a Team if prompted (any name works)\n4. Click **Create App** (or go to [apps/create](https://developer-dashboard.whoop.com/apps/create))\n5. Fill in:\n   - **App name**: anything (e.g., \"Clawdbot\")\n   - **Scopes**: select ALL: `read:recovery`, `read:cycles`, `read:workout`, `read:sleep`, `read:profile`, `read:body_measurement`\n   - **Redirect URI**: `http://localhost:9876/callback`\n6. Click **Create** — you'll get a **Client ID** and **Client Secret**\n\n### 2. Authenticate\n\nRun the OAuth login flow with your credentials:\n\n```bash\npython3 scripts/whoop_auth.py login \\\n  --client-id YOUR_CLIENT_ID \\\n  --client-secret YOUR_CLIENT_SECRET\n```\n\nThis opens a browser for Whoop authorization. Log in and approve access. Tokens are stored in `~/.clawdbot/whoop-tokens.json` and auto-refresh.\n\nCheck status: `python3 scripts/whoop_auth.py status`\n\n## Fetching Data\n\nUse `scripts/whoop_data.py` to get JSON data:\n\n```bash\n# Sleep (last 7 days default)\npython3 scripts/whoop_data.py sleep --days 14\n\n# Recovery scores\npython3 scripts/whoop_data.py recovery --days 30\n\n# Strain/cycles\npython3 scripts/whoop_data.py cycles --days 7\n\n# Workouts\npython3 scripts/whoop_data.py workouts --days 30\n\n# Combined summary with averages\npython3 scripts/whoop_data.py summary --days 7\n\n# Custom date range\npython3 scripts/whoop_data.py sleep --start 2026-01-01 --end 2026-01-15\n\n# User profile / body measurements\npython3 scripts/whoop_data.py profile\npython3 scripts/whoop_data.py body\n```\n\nOutput is JSON to stdout. Parse it to answer user questions.\n\n## Generating Charts\n\nUse `scripts/whoop_chart.py` for interactive HTML visualizations:\n\n```bash\n# Sleep analysis (performance + stages)\npython3 scripts/whoop_chart.py sleep --days 30\n\n# Recovery bars (color-coded green/yellow/red)\npython3 scripts/whoop_chart.py recovery --days 30\n\n# Strain & calories trend\npython3 scripts/whoop_chart.py strain --days 90\n\n# HRV & resting heart rate trend\npython3 scripts/whoop_chart.py hrv --days 90\n\n# Full dashboard (all 4 charts)\npython3 scripts/whoop_chart.py dashboard --days 30\n\n# Save to specific file\npython3 scripts/whoop_chart.py dashboard --days 90 --output ~/Desktop/whoop.html\n```\n\nCharts open automatically in the default browser. They use Chart.js with dark theme, stat cards, and tooltips.\n\n## Answering Questions\n\n| User asks | Action |\n|-----------|--------|\n| \"How did I sleep?\" | `whoop_data.py summary --days 7`, report sleep performance + hours |\n| \"How's my recovery?\" | `whoop_data.py recovery --days 7`, report scores + trend |\n| \"Show me a chart for the last month\" | `whoop_chart.py dashboard --days 30` |\n| \"Is my HRV improving?\" | `whoop_data.py recovery --days 30`, analyze trend |\n| \"How much did I train this week?\" | `whoop_data.py workouts --days 7`, list activities |\n\n## Key Metrics\n\n- **Recovery** (0-100%): Green ≥67%, Yellow 34-66%, Red <34%\n- **Strain** (0-21): Daily exertion score based on HR\n- **Sleep Performance**: Actual sleep vs. sleep needed\n- **HRV** (ms): Higher = better recovery, track trend over time\n- **RHR** (bpm): Lower = better cardiovascular fitness\n\n## Health Analysis\n\nWhen the user asks about their health, trends, or wants insights, use `references/health_analysis.md` for:\n- Science-backed interpretation of HRV, RHR, sleep stages, recovery, strain, SpO2\n- Normal ranges by age and fitness level\n- Pattern detection (day-of-week effects, sleep debt, overtraining signals)\n- Actionable recommendations based on data\n- Red flags that suggest medical consultation\n\n### Analysis workflow\n1. Fetch data: `python3 scripts/whoop_data.py summary --days N`\n2. Read `references/health_analysis.md` for interpretation framework\n3. Apply the 5-step analysis: Status → Trends → Patterns → Insights → Flags\n4. Always include disclaimer that this is not medical advice\n\n## References\n\n- `references/api.md` — endpoint details, response schemas, pagination\n- `references/health_analysis.md` — science-backed health data interpretation guide\n","tags":{"latest":"1.1.0"},"stats":{"comments":0,"downloads":2857,"installsAllTime":6,"installsCurrent":6,"stars":4,"versions":4},"createdAt":1769265605225,"updatedAt":1778485848771},"latestVersion":{"version":"1.1.0","createdAt":1769266238909,"changelog":"Upgraded charts to ApexCharts: zoom/pan, gradient fills, recovery zone annotations, HRV 7-day moving average, short date labels, smooth animations. Fixed dashboard rendering issues.","license":null},"metadata":null,"owner":{"handle":"rodrigouroz","userId":"s176ytpjj1vxayxxremsryad5983en53","displayName":"rodrigouroz","image":"https://avatars.githubusercontent.com/u/384037?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779915922591}}