expo-healthkit skill
Skill that teaches agents to write @appeeky/expo-healthkit code: one API for Apple HealthKit and Android Health Connect in Expo.
- 109 ★ on the repository
- Last commit
Extended access
Why this level
- The app handles sensitive health data, so access request texts and a privacy policy must be precise.
- Write permissions in HealthKit and Health Connect should be requested only for the types needed.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/expo-healthkitDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The app handles sensitive health data, so access request texts and a privacy policy must be precise.
- Write permissions in HealthKit and Health Connect should be requested only for the types needed.
This is third-party code. Review the repository files before installing.
What it does
The repository holds the `@appeeky/expo-healthkit` library for Expo and React Native and the `.cursor/skills/expo-healthkit` skill for agents. An app passes Apple HealthKit identifiers (`HKQuantityTypeIdentifierStepCount` and others), reads and saves samples, and the native layer talks to HealthKit on iOS and Health Connect on Android. The skill consists of `SKILL.md`, `reference.md`, `examples.md` and `background-delivery.md`: which query to pick, authorization rules, config plugin flags, method signatures and units. The folder is copied into the project skills directory.
Who it is for. Expo mobile developers adding steps, heart rate, sleep or workouts to an app who want the agent to keep the two platforms straight.
Good fit when
- An app reads steps and heart rate from Apple Health and Health Connect with one codebase.
- The agent configures the config plugin with read and write permissions.
- iOS needs background delivery of new HealthKit data.
- A developer checks method signatures and measurement units.
Not a fit when
- The app runs in Expo Go; the module needs a development build.
- The project is neither Expo nor React Native.
- The Expo SDK version is below 53.
Example request
Add a screen with today steps and request read access to steps and heart rate through `expo-healthkit`.Limitations
The module works only in a development build; Expo Go does not fit. It needs Expo SDK 53 or newer with the New Architecture, iOS 16.4+ and Android 8+. The HealthKit capability is enabled for the App ID in the Apple Developer portal; the plugin only writes the entitlement into the project. Android needs Health Connect installed, built in from Android 14. On the web `isAvailable()` returns `false`. Native code changes need a rebuild; a Metro reload is not enough.
How to disable. Delete the `expo-healthkit` folder from the project skills directory. Remove the library from `package.json` and the `app.json` plugins, then rebuild native code.
FAQ
Does it work in Expo Go?
No. Health data access needs a development build: `npx expo run:ios` or `npx expo run:android`.
What do I pass in queries?
Apple HealthKit type identifiers such as `HKQuantityTypeIdentifierStepCount`. On Android the library maps them to Health Connect types.
How do I narrow Android permissions?
The `healthConnectPermissions` option of the config plugin limits the list. By default the plugin declares every mapped type.
What do I copy for the agent?
The whole `.cursor/skills/expo-healthkit/` folder. It gives Cursor, Claude Code and Copilot agents query-selection rules and a method reference.
Which platforms are supported?
iOS 16.4 or newer and Android 8 or newer (API 26). On the web `isAvailable()` returns `false` and query methods throw `HealthKitUnavailableError`.
Discussion
No questions or reviews yet.
Related
SkillsA Claude Code skill that builds Expo mobile apps with onboarding, paid subscriptions, AdMob ads, analytics and localization.
Evan Bacon's skill teaches an agent to add widgets, App Clips, Safari extensions and other native Apple targets to an Expo app
Expo's official agent skills: building, deploying, updating and debugging Expo and EAS apps
Callstack agent skills for React Native
Callstack Agent Skills
Callstack's React Native skills: performance, version upgrades, native app migration, testing and CI
An agent checks Apple app code against every App Store guideline and shows what could trigger a rejection before you submit
Three skills for Claude Code and Cursor: add Storybook v10 to React Native, write CSF stories and upgrade one version step at a time
README in short
One pair of query and save methods on both platforms plus a config plugin for HealthKit and Health Connect permissions. On the web the module reports itself as unavailable.