{
  "schemaVersion": "1.0",
  "item": {
    "slug": "apple-health",
    "name": "Apple Health",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/apple-health",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/apple-health",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/apple-health",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=apple-health",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "fallback-cli.md",
      "mcp-config.md",
      "memory-template.md",
      "query-recipes.md",
      "setup.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. 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/apple-health"
    },
    "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/apple-health",
    "agentPageUrl": "https://openagent3.xyz/skills/apple-health/agent",
    "manifestUrl": "https://openagent3.xyz/skills/apple-health/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/apple-health/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": "Setup",
        "body": "On first use, read setup.md for integration guidelines."
      },
      {
        "title": "When to Use",
        "body": "User wants agents to read Apple Health data for trends, summaries, or SQL analysis. Agent handles export validation, MCP server wiring, and safe query/report flows without exposing private health records."
      },
      {
        "title": "Architecture",
        "body": "Memory lives in ~/apple-health/. See memory-template.md for setup.\n\n~/apple-health/\n|-- memory.md              # Status, client integration state, latest export path\n|-- integrations.md        # Connected MCP clients and validation notes\n|-- query-log.md           # Reusable SQL/report prompts and known-good outputs\n`-- archive/               # Retired paths and old troubleshooting notes"
      },
      {
        "title": "Quick Reference",
        "body": "Use these files on demand instead of overloading the main instructions.\n\nTopicFileSetup processsetup.mdMemory templatememory-template.mdMCP client wiringmcp-config.mdQuery recipesquery-recipes.mdFallback CLI pathsfallback-cli.md"
      },
      {
        "title": "1. Confirm Integration Mode Before Doing Anything",
        "body": "Start by clarifying one of these modes:\n\ncsv-export using Apple Health CSV exports and MCP\nnot-now if user is only planning and does not want setup yet\n\nNever imply direct HealthKit API access from terminal agents. This skill works from exported data."
      },
      {
        "title": "2. Validate Local Export Before MCP Wiring",
        "body": "Require a real export folder before configuration:\n\nMust exist locally and be readable\nMust include files matching HKQuantityTypeIdentifier*.csv, HKCategoryTypeIdentifier*.csv, or HKWorkoutActivityType*.csv\nMust not be an empty unzip folder\n\nIf validation fails, stop and fix data path first."
      },
      {
        "title": "3. Run Runtime Preflight Before MCP Configuration",
        "body": "Before wiring MCP, verify runtime:\n\nnode -v should be an LTS line (18, 20, or 22)\nIf npx @neiltron/apple-health-mcp fails with missing duckdb.node, switch to LTS Node and retry\nConfirm HEALTH_DATA_DIR is available as an absolute path\n\nDo not continue while runtime is incompatible."
      },
      {
        "title": "4. Configure MCP With Explicit Path and Command",
        "body": "Use the MCP server command from mcp-config.md:\n\nCommand: npx\nArgs: [@neiltron/apple-health-mcp]\nEnv: HEALTH_DATA_DIR=/absolute/path/to/export\n\nNever continue with placeholders or relative paths that are not verified."
      },
      {
        "title": "5. Schema First, Then Queries",
        "body": "First run schema discovery (health_schema) and map available tables.\nOnly then run health_query or health_report.\n\nIf table names differ from expectation, adapt SQL to discovered schema instead of forcing guessed names."
      },
      {
        "title": "6. Use Date-Bounded Queries By Default",
        "body": "Every analytical query should include time bounds and clear units.\nPrefer rolling windows (last 7d, 30d, 90d) and compare at most two windows at once.\n\nAvoid unbounded full-history scans unless user explicitly asks."
      },
      {
        "title": "7. Track Data Freshness and Refresh Points",
        "body": "Log last export timestamp in memory and warn when data is stale.\nIf user needs current-day insights, request a new iPhone export before claiming \"latest\" trends."
      },
      {
        "title": "Common Traps",
        "body": "Assuming live HealthKit access from CLI agents -> setup fails because only exported data is available\nUsing wrong export path in MCP env -> server starts but returns no data\nRunning SQL before schema discovery -> queries fail on wrong table names\nUnbounded queries on large exports -> slow analysis and noisy output\nReporting \"today\" metrics from stale export -> inaccurate recommendations\nRunning MCP package on non-LTS Node -> DuckDB native module errors can break startup"
      },
      {
        "title": "External Endpoints",
        "body": "EndpointData SentPurposehttps://registry.npmjs.orgPackage install metadata onlyDownload MCP server packagehttps://raw.githubusercontent.comPublic markdown onlyRead validated fallback skill docshttps://apps.apple.comManual app download trafficInstall CSV export app on iPhone\n\nNo health record rows should be sent externally by default."
      },
      {
        "title": "Security & Privacy",
        "body": "Data that leaves your machine:\n\nPackage install requests to npm\nOptional app download traffic from App Store\n\nData that stays local:\n\nApple Health CSV exports\nMCP query outputs and summaries\nSkill memory in ~/apple-health/\n\nThis skill does NOT:\n\nAccess iCloud Health data directly\nBypass Apple permission prompts\nUpload health CSVs unless the user asks for that explicitly"
      },
      {
        "title": "Trust",
        "body": "By using this skill, you rely on third-party tooling (@neiltron/apple-health-mcp and the chosen iPhone export app).\nOnly install and run if you trust those tools."
      },
      {
        "title": "Related Skills",
        "body": "Install with clawhub install <slug> if user confirms:\n\nhealth - General health guidance boundaries and framing\nios - iOS-specific setup and platform troubleshooting\nsleep - Sleep trend interpretation workflows\napi - Reliable API and integration debugging habits\nswift - HealthKit-side implementation context when app code is involved"
      },
      {
        "title": "Feedback",
        "body": "If useful: clawhub star apple-health\nStay updated: clawhub sync"
      }
    ],
    "body": "Setup\n\nOn first use, read setup.md for integration guidelines.\n\nWhen to Use\n\nUser wants agents to read Apple Health data for trends, summaries, or SQL analysis. Agent handles export validation, MCP server wiring, and safe query/report flows without exposing private health records.\n\nArchitecture\n\nMemory lives in ~/apple-health/. See memory-template.md for setup.\n\n~/apple-health/\n|-- memory.md              # Status, client integration state, latest export path\n|-- integrations.md        # Connected MCP clients and validation notes\n|-- query-log.md           # Reusable SQL/report prompts and known-good outputs\n`-- archive/               # Retired paths and old troubleshooting notes\n\nQuick Reference\n\nUse these files on demand instead of overloading the main instructions.\n\nTopic\tFile\nSetup process\tsetup.md\nMemory template\tmemory-template.md\nMCP client wiring\tmcp-config.md\nQuery recipes\tquery-recipes.md\nFallback CLI paths\tfallback-cli.md\nCore Rules\n1. Confirm Integration Mode Before Doing Anything\n\nStart by clarifying one of these modes:\n\ncsv-export using Apple Health CSV exports and MCP\nnot-now if user is only planning and does not want setup yet\n\nNever imply direct HealthKit API access from terminal agents. This skill works from exported data.\n\n2. Validate Local Export Before MCP Wiring\n\nRequire a real export folder before configuration:\n\nMust exist locally and be readable\nMust include files matching HKQuantityTypeIdentifier*.csv, HKCategoryTypeIdentifier*.csv, or HKWorkoutActivityType*.csv\nMust not be an empty unzip folder\n\nIf validation fails, stop and fix data path first.\n\n3. Run Runtime Preflight Before MCP Configuration\n\nBefore wiring MCP, verify runtime:\n\nnode -v should be an LTS line (18, 20, or 22)\nIf npx @neiltron/apple-health-mcp fails with missing duckdb.node, switch to LTS Node and retry\nConfirm HEALTH_DATA_DIR is available as an absolute path\n\nDo not continue while runtime is incompatible.\n\n4. Configure MCP With Explicit Path and Command\n\nUse the MCP server command from mcp-config.md:\n\nCommand: npx\nArgs: [@neiltron/apple-health-mcp]\nEnv: HEALTH_DATA_DIR=/absolute/path/to/export\n\nNever continue with placeholders or relative paths that are not verified.\n\n5. Schema First, Then Queries\n\nFirst run schema discovery (health_schema) and map available tables. Only then run health_query or health_report.\n\nIf table names differ from expectation, adapt SQL to discovered schema instead of forcing guessed names.\n\n6. Use Date-Bounded Queries By Default\n\nEvery analytical query should include time bounds and clear units. Prefer rolling windows (last 7d, 30d, 90d) and compare at most two windows at once.\n\nAvoid unbounded full-history scans unless user explicitly asks.\n\n7. Track Data Freshness and Refresh Points\n\nLog last export timestamp in memory and warn when data is stale. If user needs current-day insights, request a new iPhone export before claiming \"latest\" trends.\n\nCommon Traps\nAssuming live HealthKit access from CLI agents -> setup fails because only exported data is available\nUsing wrong export path in MCP env -> server starts but returns no data\nRunning SQL before schema discovery -> queries fail on wrong table names\nUnbounded queries on large exports -> slow analysis and noisy output\nReporting \"today\" metrics from stale export -> inaccurate recommendations\nRunning MCP package on non-LTS Node -> DuckDB native module errors can break startup\nExternal Endpoints\nEndpoint\tData Sent\tPurpose\nhttps://registry.npmjs.org\tPackage install metadata only\tDownload MCP server package\nhttps://raw.githubusercontent.com\tPublic markdown only\tRead validated fallback skill docs\nhttps://apps.apple.com\tManual app download traffic\tInstall CSV export app on iPhone\n\nNo health record rows should be sent externally by default.\n\nSecurity & Privacy\n\nData that leaves your machine:\n\nPackage install requests to npm\nOptional app download traffic from App Store\n\nData that stays local:\n\nApple Health CSV exports\nMCP query outputs and summaries\nSkill memory in ~/apple-health/\n\nThis skill does NOT:\n\nAccess iCloud Health data directly\nBypass Apple permission prompts\nUpload health CSVs unless the user asks for that explicitly\nTrust\n\nBy using this skill, you rely on third-party tooling (@neiltron/apple-health-mcp and the chosen iPhone export app). Only install and run if you trust those tools.\n\nRelated Skills\n\nInstall with clawhub install <slug> if user confirms:\n\nhealth - General health guidance boundaries and framing\nios - iOS-specific setup and platform troubleshooting\nsleep - Sleep trend interpretation workflows\napi - Reliable API and integration debugging habits\nswift - HealthKit-side implementation context when app code is involved\nFeedback\nIf useful: clawhub star apple-health\nStay updated: clawhub sync"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ivangdavila/apple-health",
    "publisherUrl": "https://clawhub.ai/ivangdavila/apple-health",
    "owner": "ivangdavila",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/apple-health",
    "downloadUrl": "https://openagent3.xyz/downloads/apple-health",
    "agentUrl": "https://openagent3.xyz/skills/apple-health/agent",
    "manifestUrl": "https://openagent3.xyz/skills/apple-health/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/apple-health/agent.md"
  }
}