Healthkit Sync

What it does

When your agent uses it

• Working with healthsync CLI
• Fetching Apple Health data (steps
• Pairing iOS devices over local network
• Understanding the iOS Health Sync project architecture including mTLS certificate pinning

Example prompts

• “/healthkit-sync”

Requirements

• Compatibility (from SKILL.md): macOS with healthsync CLI installed (~/.healthsync/config.json)

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

1. 1First pairing stores fingerprint from QR code
2. 2Subsequent connections verify fingerprint matches
3. 3Mismatch = connection rejected (MITM protection)

What it can do on your machine

Read from SKILL.md and the folder at commit b80cde2. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • jq

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  macOS with healthsync CLI installed (~/.healthsync/config.json)

  From compatibility in the SKILL.md frontmatter.

Context cost

Healthkit Sync loads about 1.1k tokens when it runs, and up to ~5k if it reads all its reference files. Until then it costs about 85 tokens; SKILL.md has 303 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~85

When it runs · the whole SKILL.md, loaded when a task matches

~1.1k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sundial-org/awesome-openclaw-skills at commit b80cde2, republished under its Apache-2.0 licence (© sundial-org). 303 words, ~1,149 tokens.

name

healthkit-sync

description

iOS HealthKit data sync CLI commands and patterns. Use when working with healthsync CLI, fetching Apple Health data (steps, heart rate, sleep, workouts), pairing iOS devices over local network, or understanding the iOS Health Sync project architecture including mTLS certificate pinning, Keychain storage, and audit logging.

compatibility

macOS with healthsync CLI installed (~/.healthsync/config.json)

license

Apache-2.0

metadata.category

development

metadata.platforms

ios,macos

metadata.author

mneves

# 1. Discover devices on local network
healthsync discover

# 2. On iOS app: tap "Share" to generate QR code, then "Copy"
# 3. Scan QR from clipboard (Universal Clipboard)
healthsync scan

# Alternative: scan from image file
healthsync scan --file ~/Desktop/qr.png

# Check connection status
healthsync status

# List enabled data types
healthsync types

# Fetch data as CSV (default)
healthsync fetch --start 2026-01-01T00:00:00Z --end 2026-12-31T23:59:59Z --types steps

# Fetch multiple types as JSON
healthsync fetch --start 2026-01-01T00:00:00Z --end 2026-12-31T23:59:59Z \
  --types steps,heartRate,sleepAnalysis --format json | jq

# Pipe to file
healthsync fetch --start 2026-01-01T00:00:00Z --end 2026-12-31T23:59:59Z \
  --types steps > steps.csv

{
  "host": "192.168.1.x",
  "port": 8443,
  "fingerprint": "sha256-certificate-fingerprint"
}

ai-health-sync-ios-clawdbot/
├── iOS Health Sync App/          # Swift 6 iOS app
│   ├── Services/Security/        # CertificateService, KeychainStore, PairingService
│   ├── Services/HealthKit/       # HealthKitService, HealthSampleMapper
│   ├── Services/Network/         # NetworkServer (TLS), HTTPTypes
│   └── Services/Audit/           # AuditService (SwiftData)
└── macOS/HealthSyncCLI/          # Swift Package CLI

© sundial-org, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in skills/healthkit-sync of sundial-org/awesome-openclaw-skills.

• SKILL.md
• TESTING.md
• references/ARCHITECTURE.md
• references/CLI-REFERENCE.md
• references/SECURITY.md

Open the folder on GitHubat commit b80cde2