{
  "schemaVersion": "1.0",
  "item": {
    "slug": "fitbit-insights",
    "name": "Fitbit Insights",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/poisondminds/fitbit-insights",
    "canonicalUrl": "https://clawhub.ai/poisondminds/fitbit-insights",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/fitbit-insights",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fitbit-insights",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CLAWHUB-SUBMISSION.md",
      "OVERVIEW.md",
      "README.md",
      "SETUP.md",
      "SKILL.md"
    ],
    "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.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/fitbit-insights"
    },
    "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/fitbit-insights",
    "agentPageUrl": "https://openagent3.xyz/skills/fitbit-insights/agent",
    "manifestUrl": "https://openagent3.xyz/skills/fitbit-insights/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/fitbit-insights/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Fitbit Fitness Insights",
        "body": "Get AI-powered insights from your Fitbit data. Query your fitness metrics, analyze trends, and ask questions about your activity."
      },
      {
        "title": "Features",
        "body": "📊 Daily activity summaries (steps, calories, distance, active minutes)\n💓 Heart rate data and zones\n😴 Sleep tracking and analysis\n🏃 Workout/activity logs\n📈 Weekly and trend analysis\n🤖 AI-powered insights and Q&A"
      },
      {
        "title": "Prerequisites",
        "body": "Requires: Fitbit OAuth access token\n\nSetup steps in references/fitbit-oauth-setup.md"
      },
      {
        "title": "Get Profile",
        "body": "FITBIT_ACCESS_TOKEN=\"...\" python3 scripts/fitbit_api.py profile"
      },
      {
        "title": "Daily Activity",
        "body": "python3 scripts/fitbit_api.py daily [date]\n# Examples:\npython3 scripts/fitbit_api.py daily              # Today\npython3 scripts/fitbit_api.py daily 2026-02-08   # Specific date\n\nReturns: steps, distance, calories, active minutes (very/fairly/lightly/sedentary), floors"
      },
      {
        "title": "Steps Range",
        "body": "python3 scripts/fitbit_api.py steps <start_date> <end_date>\n\nExample:\n\npython3 scripts/fitbit_api.py steps 2026-02-01 2026-02-07\n\nReturns: total steps, average steps, daily breakdown"
      },
      {
        "title": "Heart Rate",
        "body": "python3 scripts/fitbit_api.py heart [date]\n\nReturns: resting heart rate, heart rate zones with minutes in each zone"
      },
      {
        "title": "Sleep Data",
        "body": "python3 scripts/fitbit_api.py sleep [date]\n\nReturns: duration, efficiency, start/end times, sleep stages"
      },
      {
        "title": "Logged Activities",
        "body": "python3 scripts/fitbit_api.py activities [date]\n\nReturns: workouts/activities logged (name, duration, calories, distance)"
      },
      {
        "title": "Weekly Summary",
        "body": "python3 scripts/fitbit_api.py weekly\n\nReturns: 7-day summary of steps and key metrics"
      },
      {
        "title": "AI Insights Usage",
        "body": "When user asks fitness questions, use the API to fetch relevant data, then provide insights:\n\nExample queries:\n\n\"How did I sleep last night?\" → fetch sleep data, analyze quality\n\"Did I hit my step goal this week?\" → fetch weekly summary, compare to goals\n\"What was my average heart rate during workouts?\" → fetch heart + activities, analyze\n\"Am I more active on weekdays or weekends?\" → fetch range data, compare patterns\n\nAnalysis approach:\n\nIdentify what data is needed\nFetch via appropriate API command\nAnalyze the data\nProvide insights in conversational format"
      },
      {
        "title": "Example Responses",
        "body": "User: \"How did I do this week?\"\n\nAgent:\n\nFetch weekly summary\nFetch recent sleep data\nRespond: \"You had a solid week! Averaged 8,234 steps/day (up 12% from last week). Hit your 10k step goal 4 out of 7 days. Sleep averaged 7.2 hours with 85% efficiency. CrossFit sessions on Mon/Wed/Fri looking consistent!\"\n\nUser: \"Did I exercise today?\"\n\nAgent:\n\nFetch daily activities\nFetch daily activity summary (active minutes)\nRespond: \"Yes! You logged a CrossFit session this morning (45 min, 312 calories). Plus 28 very active minutes total for the day.\""
      },
      {
        "title": "Data Insights to Look For",
        "body": "Trends: Week-over-week changes, consistency patterns\nGoals: Compare to 10k steps, exercise frequency, sleep targets\nCorrelations: Sleep quality vs activity, rest days vs performance\nAnomalies: Unusual spikes or drops\nAchievements: Personal bests, streaks, milestones"
      },
      {
        "title": "Token Management",
        "body": "The skill automatically loads tokens from /root/clawd/fitbit-config.json and refreshes them when expired (every 8 hours).\n\nAuto-refresh: Tokens are refreshed automatically - no manual intervention needed!\n\nManual refresh (if needed):\n\npython3 scripts/refresh_token.py force\n\nOverride with environment variable:\n\nexport FITBIT_ACCESS_TOKEN=\"manual_token\""
      },
      {
        "title": "Error Handling",
        "body": "Missing token: Prompt user to set FITBIT_ACCESS_TOKEN\nAPI errors: Check token validity, may need refresh\nNo data: Some days may have no logged activities or missing metrics\n\nSee references/fitbit-oauth-setup.md for token management."
      }
    ],
    "body": "Fitbit Fitness Insights\n\nGet AI-powered insights from your Fitbit data. Query your fitness metrics, analyze trends, and ask questions about your activity.\n\nFeatures\n📊 Daily activity summaries (steps, calories, distance, active minutes)\n💓 Heart rate data and zones\n😴 Sleep tracking and analysis\n🏃 Workout/activity logs\n📈 Weekly and trend analysis\n🤖 AI-powered insights and Q&A\nPrerequisites\n\nRequires: Fitbit OAuth access token\n\nSetup steps in references/fitbit-oauth-setup.md\n\nCommands\nGet Profile\nFITBIT_ACCESS_TOKEN=\"...\" python3 scripts/fitbit_api.py profile\n\nDaily Activity\npython3 scripts/fitbit_api.py daily [date]\n# Examples:\npython3 scripts/fitbit_api.py daily              # Today\npython3 scripts/fitbit_api.py daily 2026-02-08   # Specific date\n\n\nReturns: steps, distance, calories, active minutes (very/fairly/lightly/sedentary), floors\n\nSteps Range\npython3 scripts/fitbit_api.py steps <start_date> <end_date>\n\n\nExample:\n\npython3 scripts/fitbit_api.py steps 2026-02-01 2026-02-07\n\n\nReturns: total steps, average steps, daily breakdown\n\nHeart Rate\npython3 scripts/fitbit_api.py heart [date]\n\n\nReturns: resting heart rate, heart rate zones with minutes in each zone\n\nSleep Data\npython3 scripts/fitbit_api.py sleep [date]\n\n\nReturns: duration, efficiency, start/end times, sleep stages\n\nLogged Activities\npython3 scripts/fitbit_api.py activities [date]\n\n\nReturns: workouts/activities logged (name, duration, calories, distance)\n\nWeekly Summary\npython3 scripts/fitbit_api.py weekly\n\n\nReturns: 7-day summary of steps and key metrics\n\nAI Insights Usage\n\nWhen user asks fitness questions, use the API to fetch relevant data, then provide insights:\n\nExample queries:\n\n\"How did I sleep last night?\" → fetch sleep data, analyze quality\n\"Did I hit my step goal this week?\" → fetch weekly summary, compare to goals\n\"What was my average heart rate during workouts?\" → fetch heart + activities, analyze\n\"Am I more active on weekdays or weekends?\" → fetch range data, compare patterns\n\nAnalysis approach:\n\nIdentify what data is needed\nFetch via appropriate API command\nAnalyze the data\nProvide insights in conversational format\nExample Responses\n\nUser: \"How did I do this week?\"\n\nAgent:\n\nFetch weekly summary\nFetch recent sleep data\nRespond: \"You had a solid week! Averaged 8,234 steps/day (up 12% from last week). Hit your 10k step goal 4 out of 7 days. Sleep averaged 7.2 hours with 85% efficiency. CrossFit sessions on Mon/Wed/Fri looking consistent!\"\n\nUser: \"Did I exercise today?\"\n\nAgent:\n\nFetch daily activities\nFetch daily activity summary (active minutes)\nRespond: \"Yes! You logged a CrossFit session this morning (45 min, 312 calories). Plus 28 very active minutes total for the day.\"\nData Insights to Look For\nTrends: Week-over-week changes, consistency patterns\nGoals: Compare to 10k steps, exercise frequency, sleep targets\nCorrelations: Sleep quality vs activity, rest days vs performance\nAnomalies: Unusual spikes or drops\nAchievements: Personal bests, streaks, milestones\nToken Management\n\nThe skill automatically loads tokens from /root/clawd/fitbit-config.json and refreshes them when expired (every 8 hours).\n\nAuto-refresh: Tokens are refreshed automatically - no manual intervention needed!\n\nManual refresh (if needed):\n\npython3 scripts/refresh_token.py force\n\n\nOverride with environment variable:\n\nexport FITBIT_ACCESS_TOKEN=\"manual_token\"\n\nError Handling\nMissing token: Prompt user to set FITBIT_ACCESS_TOKEN\nAPI errors: Check token validity, may need refresh\nNo data: Some days may have no logged activities or missing metrics\n\nSee references/fitbit-oauth-setup.md for token management."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/poisondminds/fitbit-insights",
    "publisherUrl": "https://clawhub.ai/poisondminds/fitbit-insights",
    "owner": "poisondminds",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/fitbit-insights",
    "downloadUrl": "https://openagent3.xyz/downloads/fitbit-insights",
    "agentUrl": "https://openagent3.xyz/skills/fitbit-insights/agent",
    "manifestUrl": "https://openagent3.xyz/skills/fitbit-insights/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/fitbit-insights/agent.md"
  }
}