- name
SKILL.md
스킬 파일은 게시자의 저장소에 그대로 있습니다.
복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add win4r/MuseAI-Skills --skill apple-healthkit -a cursor -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add win4r/MuseAI-Skills --skill apple-healthkit -a claude-code -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add win4r/MuseAI-Skills --skill apple-healthkit -a codex -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add win4r/MuseAI-Skills --skill apple-healthkit -a grok -y복사한 메시지를 Grok Bot 채팅에 보냅니다. Bot이 GitHub에서 이 SKILL.md를 가져와 모든 Bot이 공유하는 스킬에 추가합니다.
Install this skill: https://github.com/win4r/MuseAI-Skills/tree/HEAD/opt/hatch/skills/apple-healthkit게시자 제공
Read the user's synced Apple HealthKit data with the health-cli binary. Every
command below takes --provider healthkit.
This skill serves iOS devices only. If the user's paired device is not an
iPhone, it has no data for them — check the platform field
returned by device.list when you are unsure.
Despite syned from apple healthkit, do not assume the data is originated from ios devices only. It could come from other sources/devices which share data with Apple Healthkit.
When the user asks about their synced HealthKit data, sync status, or sources:
Binary: health-cli. --provider healthkit is required on every command
below — it is not optional and has no default; omitting it is a usage error.
Commands group by data shape under query:
query metrics --provider healthkit — all-day metric rollupsquery samples --provider healthkit — raw, unbucketed data points (intraday HR/steps, GPS, sleep stages)query sessions --provider healthkit — discrete sessions: sleep, workoutstatus --provider healthkit — data-sync statusauth connect --provider healthkit, auth disconnect --provider healthkitdelete — erase stored records (destructive; see below)Multi-device (rare): when a window spans >1 device the envelope adds
"multi_node": true — query metrics returns per-device node_groups;
query samples/sessions add a node_id to each record (samples CSV gains a
leading node_id column). Single-device output is unchanged; never sum or
double-count across devices.
health-cli query metrics --provider healthkit \
--start-date <YYYY-MM-DD> [--end-date <YYYY-MM-DD>] \
[--interval hourly|daily|weekly] [--fields a,b,c] [--timeout-secs N]
daily-metrics is the only domain so there is no --category. One row per
--interval bucket (default daily). --start-date required; --end-date
defaults to today. Output is an envelope { "coverage": {...}, "records": [...] }
(see Coverage below).
--list-fields reads the metric field names from the synced data →
{ ok, provider, category, observed_count, fields: [{ name, observed, count? }] }.
observed: true (with a row count) means the name is present in this user's
data — those are exactly the names --fields matches. observed: false means
the build knows the field but nothing has synced yet. If the field set can't be
read the response carries degraded: true and every observed is null.
health-cli query sessions --provider healthkit --category sleep|workout \
--start-date <YYYY-MM-DD> [--end-date <YYYY-MM-DD>] [--fields a,b,c]
sleep — one row per sleep session.workout — one row per workout/activity.Sessions are never bucketed (no --interval). Discovery: --list-categories →
{ ok, provider, categories }; --list-fields (needs --category) →
{ ok, provider, category, fields } (e.g. workout has is_indoor).
Output: normalized snake_case records; the same concept uses the same field
name (e.g. workout average_speed_mps, elevation_gain_meters,
hr_average_bpm). Session records carry a provider-prefixed id
(healthkit_…) + start_datetime/end_datetime/timezone; metric buckets
carry date/hour/week_start + record_count.
Coverage: queries return an envelope { "coverage": {...}, "records": [...] }.
coverage.complete is false when days in the window aren't synced from the
device; coverage.warning then holds the exact backfill_data_source command
to run. Surface that warning to the user / act on it — results are partial
until the backfill completes.
health-cli query samples --provider healthkit --start-date <YYYY-MM-DD> \
[--end-date <YYYY-MM-DD>] [--start-time <HH:MM[:SS]>] [--end-time <HH:MM[:SS]>] \
[--fields <type1,...>] [--limit <n>] [--format stdout|csv] [--output <path>]
health-cli query samples --provider healthkit --list-fields # discover sample types
Individual samples — finer than the query metrics rollups (intraday HR/steps,
GPS, sleep-stage timelines; query sessions gives stage totals only). --fields
selects sample types (not output columns) — run --list-fields to see the
types this user has synced. GPS is location (raw lat/lon — don't infer place
names from it). For dense reads use --output <path>: it writes CSV into the
agent filesystem for a later script step and prints only a summary, keeping
thousands of rows out of context.
health-cli status --provider healthkit [--timeout-secs N] \
[--start-date <YYYY-MM-DD>] [--end-date <YYYY-MM-DD>] [--check-missing-entries]
Returns { categories: [{ name, record_count, earliest_datetime, latest_datetime }] }. With --check-missing-entries (requires --start-date):
a deep per-30-min-interval gap report (unsynced_dates, missing_intervals, …).
health-cli auth connect --provider healthkit [--timeout-secs N]
Run this and follow the instruction to connect to apple healthkit data.
health-cli auth disconnect --provider healthkit [--timeout-secs N]
Apple Health cannot be disconnected through this CLI or an in-chat widget. Tell the user to open Settings → Connectors → Apple Health and tap Disconnect.
health-cli delete --provider healthkit --all # every Apple Health record
health-cli delete --provider healthkit --device NODE_ID # one paired device
health-cli delete --provider healthkit --start-date 2026-03-01 --end-date 2026-03-31
Use for any request to delete, remove, erase, wipe, or clear HealthKit data. Never improvise it by moving files, disconnecting the connector, or writing to the database — those neither remove records nor leave an audit trail. A delete never spans providers; to clear both, run it once per provider.
--all takes no other filter; --device/--start-date/--end-date are used
instead of it. All record kinds go at once — no per-category or per-record-ID
delete. Dates are YYYY-MM-DD in JARVIS_USER_TIMEZONE or epoch seconds; a
record is in range when it starts before the end and ends after the start, so a
session straddling a bound is included. --start-date alone deletes from that
day onward, --end-date alone up to and including it.
Destructive and irreversible, behind a fresh one-time approval showing the normalized filters. Run it once per request — settle provider, device and dates in conversation first. Denial exits code 3 with nothing deleted; that is final, so report it rather than retrying other filters or the other provider.
Zero is a success, not a miss — nothing matched, so say so and stop rather
than widening dates or re-running with --all. Report deleted.records, not
total_rows, which also counts child value rows. Apple Health is device-synced,
so records still on the device can return on a later sync.
Device-synced; no login. Data availability depends on the on-device Health
permission + sync. Use status to see synced ranges and the
backfill_data_source device action (surfaced in query coverage.warning) to
pull a range.
query metrics (all-day rollups),
query samples (raw points — only when individual samples matter; prefer
metrics for trends), or query sessions --category sleep|workout (discrete
events).--provider healthkit and --start-date; --end-date
defaults to today. Use current-date context for relative asks ("today",
"last week"); use sample time bounds for narrow intraday windows.query metrics/sessions returns coverage.complete: false, tell the user the data is partial and relay/act on coverage.warning
(run the backfill_data_source action, then re-query).query metrics defaults to --interval daily; sleep spans midnight (include
both evening start and morning end dates).status /
coverage and backfill.The user's synced Apple Health (HealthKit) data: daily metrics (steps, distance, calories, heart rate, HRV, VO2max), sleep sessions (stages, quality, efficiency), and workouts.
---name: apple_healthkitdescription: The user's synced Apple Health (HealthKit) data: daily metrics (steps, distance, calories, heart rate, HRV…---# opt/hatch/skills/apple-healthkit/SKILL.mdFAQ
게시자에게서 opt/hatch/skills/apple-healthkit/SKILL.md를 다운로드하거나 경로를 복사해 저장소를 엽니다. PlugMCP는 스킬을 목록에 올릴 뿐 파일을 호스팅하지 않습니다.
게시자가 https://github.com/win4r/MuseAI-Skills에서 관리합니다.
Claude, Cursor, Codex, Grok Build는 게시자의 저장소에서 추가한 SKILL.md를 읽을 수 있습니다. Grok Bot은 채팅에서 스킬의 GitHub 폴더 링크를 보내면 설치합니다.