axiom-health
- Repo stars 977
- Forks 74
- License MIT
- Author updated Jun 15, 2026, 03:09 AM
- Author repo Axiom
- Domain
- Other
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 94 / 100 · audit passed
- Author / version / license
- @CharlesWiltgen · MIT
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No special requirements
- Permissions
-
- Read-only
- Write / modify
- Shell exec
- Network behavior
- Local-only
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: axiom-health
description: Use when working with HealthKit, WorkoutKit, health data, workouts, or fitness features on iOS o…
category: other
runtime: no special runtime
---
# axiom-health output preview
## PART A: Task fit
- Use case: Use when working with HealthKit, WorkoutKit, health data, workouts, or fitness features on iOS or watchOS. Covers permissions, queries, background delivery, custom workouts, multidevice coordination..
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “Quick Reference / Cross-Suite Routes / Conflict Resolution” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “Use when working with HealthKit, WorkoutKit, health data, workouts, or fitness features on iOS or watchOS. Covers permissions, queries, background delivery, custom workouts, multidevice coordination.”.
- **02** When the source has headings, the agent prioritizes “Quick Reference / Cross-Suite Routes / Conflict Resolution” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, write/modify files, run shell commands; mostly runs locally; usually needs no extra API key.
## Running Rules
- read files, write/modify files, run shell commands; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options. The source mentions slash commands such as `/healthkit`, `/workoutkit`; use them first when your agent supports command triggers.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, write/modify files, run shell commands.
Start with a small task and check whether the result follows “Quick Reference / Cross-Suite Routes / Conflict Resolution”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: axiom-health
description: Use when working with HealthKit, WorkoutKit, health data, workouts, or fitness features on iOS o…
category: other
source: CharlesWiltgen/Axiom
---
# axiom-health
## When to use
- Use when working with HealthKit, WorkoutKit, health data, workouts, or fitness features on iOS or watchOS. Covers perm…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “Quick Reference / Cross-Suite Routes / Conflict Resolution” and keep inference separate from source facts.
- read files, write/modify files, run shell commands; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies. The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "axiom-health" {
input -> user goal + target files + boundaries + acceptance criteria
context -> Quick Reference / Cross-Suite Routes / Conflict Resolution
rules -> SKILL.md triggers / order / output contract
runtime -> no special runtime | read files, write/modify files, run shell commands | mostly runs locally
guardrails -> usually needs no extra API key + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
} HealthKit and WorkoutKit
You MUST use this skill for ANY HealthKit or WorkoutKit development including authorization, data queries, background delivery, workout sessions, planned workouts, wellbeing APIs (State of Mind), Medications, and Health Records.
Quick Reference
| Symptom / Task | Reference |
|---|---|
HealthKit framework model, HKHealthStore, data types, sample vs characteristic data |
See skills/fundamentals.md |
Capability setup, requestAuthorization, purpose strings, read-asymmetry, privacy |
See skills/authorization-and-privacy.md |
HKSampleQuery, Swift Concurrency query APIs, HKStatisticsCollectionQuery, sample writes |
See skills/queries.md |
Anchored queries, observer queries, HKDeletedObject, background-delivery entitlement |
See skills/sync-and-background.md |
HKWorkoutSession, HKLiveWorkoutBuilder, recovery, multi-device, iOS/iPadOS/watchOS workout tracking |
See skills/workouts.md |
Workout zones (heart-rate/power effort bands), live + retrospective OS27 |
See skills/workouts.md |
| WorkoutKit custom/planned workouts, scheduling, swimming workouts, previewing | See skills/workoutkit.md |
State of Mind, Medications API, symptom logging, menopausal state, wellbeing APIs OS27 |
See skills/wellbeing-and-medications.md |
| Health Records (FHIR), Mobility Health App, motion-based health | See skills/clinical-and-mobility.md |
Cross-Suite Routes
These topics overlap with HealthKit/WorkoutKit but live in separate suites:
watchOS presentation
- Watch-specific workout presentation (Always On, Smart Stack), complication surfaces → See axiom-watchos
- Workout app structure on Apple Watch → See axiom-watchos (
skills/platform-basics.md)
Concurrency
- Swift 6 concurrency, actors, Sendable → See axiom-concurrency
- HealthKit queries bridging to Swift Concurrency →
skills/queries.mdis the canonical example
SwiftUI
- Charts rendering for health data → See axiom-swiftui
@Observableview models for health data → See axiom-swiftui
Data and sync
- General cross-platform sync patterns (CloudKit, GRDB) → See axiom-data
- HealthKit anchored/observer queries as a generalizable sync mechanism →
skills/sync-and-background.md
Security and privacy
- Keychain storage, encryption, data-protection entitlements → See axiom-security
Conflict Resolution
axiom-health vs axiom-watchos: For workout apps on Apple Watch:
- Use axiom-health for
HKWorkoutSessionlifecycle,HKLiveWorkoutBuilder, recovery APIs, multi-device mirroring — these are HealthKit concepts, not watch concepts - Use axiom-watchos for watch-specific presentation: Always On display, Smart Stack placement, watchOS background mode coordination
- Both apply for a watch-native workout app — start with axiom-health for session lifecycle, then axiom-watchos for presentation
axiom-health vs axiom-concurrency: For HealthKit query patterns:
- Use axiom-health for which query type to choose and HealthKit-specific gotchas
- Use axiom-concurrency for general Swift 6 actor isolation rules that apply to query callbacks
axiom-health vs axiom-data: For change-tracked data synchronization:
- Use axiom-health for
HKAnchoredObjectQuery,HKObserverQuery,HKDeletedObject - Use axiom-data for application-level data sync across devices (CloudKit, GRDB, SwiftData)
Decision Tree
digraph health {
start [label="HealthKit / workout task" shape=ellipse];
what [label="What area?" shape=diamond];
start -> what;
what -> "skills/fundamentals.md" [label="framework basics, data types"];
what -> "skills/authorization-and-privacy.md" [label="permissions, purpose strings, privacy"];
what -> "skills/queries.md" [label="reading data, rollups, writes"];
what -> "skills/sync-and-background.md" [label="change tracking, background delivery"];
what -> "skills/workouts.md" [label="HKWorkoutSession, live workouts"];
what -> "skills/workoutkit.md" [label="planned/custom workouts"];
what -> "skills/wellbeing-and-medications.md" [label="State of Mind, Medications"];
what -> "skills/clinical-and-mobility.md" [label="Health Records, Mobility"];
what -> "axiom-watchos" [label="watch-specific presentation"];
what -> "axiom-concurrency" [label="general actor isolation rules"];
what -> "axiom-swiftui" [label="Charts, data visualization"];
}
Resources
WWDC: 2019-218, 2020-10182, 2020-10184, 2020-10664, 2021-10009, 2021-10287, 2022-10005, 2023-10016, 2023-10023, 2024-10084, 2024-10109, 2025-321, 2025-322
Docs: /healthkit, /healthkit/about-the-healthkit-framework, /healthkit/authorizing-access-to-health-data, /healthkit/protecting-user-privacy, /healthkit/reading-data-from-healthkit, /healthkit/running-queries-with-swift-concurrency, /healthkit/executing-anchored-object-queries, /healthkit/executing-observer-queries, /healthkit/hkworkoutsession, /healthkit/hklivewobuilder, /workoutkit, /healthkit/accessing-health-records
Skills: axiom-watchos, axiom-concurrency, axiom-swiftui, axiom-data, axiom-security
Decide Fit First
Design Intent
How To Use It
Boundaries And Review