{
  "schemaVersion": "1.0",
  "item": {
    "slug": "whoop-health-analysis",
    "name": "Whoop",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/rodrigouroz/whoop-health-analysis",
    "canonicalUrl": "https://clawhub.ai/rodrigouroz/whoop-health-analysis",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/whoop-health-analysis",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=whoop-health-analysis",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "references/api.md",
      "references/health_analysis.md",
      "scripts/whoop_auth.py",
      "scripts/whoop_chart.py",
      "scripts/whoop_data.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/whoop-health-analysis"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/whoop-health-analysis",
    "agentPageUrl": "https://openagent3.xyz/skills/whoop-health-analysis/agent",
    "manifestUrl": "https://openagent3.xyz/skills/whoop-health-analysis/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/whoop-health-analysis/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Whoop",
        "body": "Query health metrics from the Whoop API and generate interactive HTML charts."
      },
      {
        "title": "1. Create a Whoop Developer App",
        "body": "Go to developer-dashboard.whoop.com\nSign in with your Whoop account credentials\nCreate a Team if prompted (any name works)\nClick Create App (or go to apps/create)\nFill in:\n\nApp name: anything (e.g., \"Clawdbot\")\nScopes: select ALL: read:recovery, read:cycles, read:workout, read:sleep, read:profile, read:body_measurement\nRedirect URI: http://localhost:9876/callback\n\n\nClick Create — you'll get a Client ID and Client Secret"
      },
      {
        "title": "2. Authenticate",
        "body": "Run the OAuth login flow with your credentials:\n\npython3 scripts/whoop_auth.py login \\\n  --client-id YOUR_CLIENT_ID \\\n  --client-secret YOUR_CLIENT_SECRET\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"
      },
      {
        "title": "Fetching Data",
        "body": "Use scripts/whoop_data.py to get JSON data:\n\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\nOutput is JSON to stdout. Parse it to answer user questions."
      },
      {
        "title": "Generating Charts",
        "body": "Use scripts/whoop_chart.py for interactive HTML visualizations:\n\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\nCharts open automatically in the default browser. They use Chart.js with dark theme, stat cards, and tooltips."
      },
      {
        "title": "Answering Questions",
        "body": "User asksAction\"How did I sleep?\"whoop_data.py summary --days 7, report sleep performance + hours\"How's my recovery?\"whoop_data.py recovery --days 7, report scores + trend\"Show me a chart for the last month\"whoop_chart.py dashboard --days 30\"Is my HRV improving?\"whoop_data.py recovery --days 30, analyze trend\"How much did I train this week?\"whoop_data.py workouts --days 7, list activities"
      },
      {
        "title": "Key Metrics",
        "body": "Recovery (0-100%): Green ≥67%, Yellow 34-66%, Red <34%\nStrain (0-21): Daily exertion score based on HR\nSleep Performance: Actual sleep vs. sleep needed\nHRV (ms): Higher = better recovery, track trend over time\nRHR (bpm): Lower = better cardiovascular fitness"
      },
      {
        "title": "Health Analysis",
        "body": "When the user asks about their health, trends, or wants insights, use references/health_analysis.md for:\n\nScience-backed interpretation of HRV, RHR, sleep stages, recovery, strain, SpO2\nNormal ranges by age and fitness level\nPattern detection (day-of-week effects, sleep debt, overtraining signals)\nActionable recommendations based on data\nRed flags that suggest medical consultation"
      },
      {
        "title": "Analysis workflow",
        "body": "Fetch data: python3 scripts/whoop_data.py summary --days N\nRead references/health_analysis.md for interpretation framework\nApply the 5-step analysis: Status → Trends → Patterns → Insights → Flags\nAlways include disclaimer that this is not medical advice"
      },
      {
        "title": "References",
        "body": "references/api.md — endpoint details, response schemas, pagination\nreferences/health_analysis.md — science-backed health data interpretation guide"
      }
    ],
    "body": "Whoop\n\nQuery health metrics from the Whoop API and generate interactive HTML charts.\n\nSetup (first time only)\n1. Create a Whoop Developer App\nGo to developer-dashboard.whoop.com\nSign in with your Whoop account credentials\nCreate a Team if prompted (any name works)\nClick Create App (or go to apps/create)\nFill in:\nApp name: anything (e.g., \"Clawdbot\")\nScopes: select ALL: read:recovery, read:cycles, read:workout, read:sleep, read:profile, read:body_measurement\nRedirect URI: http://localhost:9876/callback\nClick Create — you'll get a Client ID and Client Secret\n2. Authenticate\n\nRun the OAuth login flow with your credentials:\n\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\nFetching Data\n\nUse scripts/whoop_data.py to get JSON data:\n\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\nGenerating Charts\n\nUse scripts/whoop_chart.py for interactive HTML visualizations:\n\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\nAnswering Questions\nUser asks\tAction\n\"How did I sleep?\"\twhoop_data.py summary --days 7, report sleep performance + hours\n\"How's my recovery?\"\twhoop_data.py recovery --days 7, report scores + trend\n\"Show me a chart for the last month\"\twhoop_chart.py dashboard --days 30\n\"Is my HRV improving?\"\twhoop_data.py recovery --days 30, analyze trend\n\"How much did I train this week?\"\twhoop_data.py workouts --days 7, list activities\nKey Metrics\nRecovery (0-100%): Green ≥67%, Yellow 34-66%, Red <34%\nStrain (0-21): Daily exertion score based on HR\nSleep Performance: Actual sleep vs. sleep needed\nHRV (ms): Higher = better recovery, track trend over time\nRHR (bpm): Lower = better cardiovascular fitness\nHealth Analysis\n\nWhen the user asks about their health, trends, or wants insights, use references/health_analysis.md for:\n\nScience-backed interpretation of HRV, RHR, sleep stages, recovery, strain, SpO2\nNormal ranges by age and fitness level\nPattern detection (day-of-week effects, sleep debt, overtraining signals)\nActionable recommendations based on data\nRed flags that suggest medical consultation\nAnalysis workflow\nFetch data: python3 scripts/whoop_data.py summary --days N\nRead references/health_analysis.md for interpretation framework\nApply the 5-step analysis: Status → Trends → Patterns → Insights → Flags\nAlways include disclaimer that this is not medical advice\nReferences\nreferences/api.md — endpoint details, response schemas, pagination\nreferences/health_analysis.md — science-backed health data interpretation guide"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/rodrigouroz/whoop-health-analysis",
    "publisherUrl": "https://clawhub.ai/rodrigouroz/whoop-health-analysis",
    "owner": "rodrigouroz",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/whoop-health-analysis",
    "downloadUrl": "https://openagent3.xyz/downloads/whoop-health-analysis",
    "agentUrl": "https://openagent3.xyz/skills/whoop-health-analysis/agent",
    "manifestUrl": "https://openagent3.xyz/skills/whoop-health-analysis/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/whoop-health-analysis/agent.md"
  }
}