healthkit

Plan HealthKit data access, queries, and workout sessions for iOS 17+ apps.

1|1|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/Borisserz/FoodTracker --skill healthkit-borisserz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: healthkit
Source: https://github.com/Borisserz/FoodTracker/tree/main/.agents/skills/healthkit
Command: npx skills add https://github.com/Borisserz/FoodTracker --skill healthkit-borisserz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apple Health stores a vast array of health and fitness data and apps need clear guidance on how to securely read, write, and query it within a modern iOS app. This skill consolidates authorization flows, data queries (sample, statistics, and time-series), background delivery, and workout session handling into a cohesive integration.

Core Features & Use Cases

  • Authorization & Data Access: request and manage permissions for required data types (e.g., stepCount, heartRate) and perform read/write operations with proper privacy handling.
  • Workouts, Background Delivery & Live Data: orchestrate HKWorkoutSession and HKLiveWorkoutBuilder, enable background delivery, and capture live metrics during workouts.
  • Platform Readiness & Real-World Use Case: gate features by availability (iOS 17+/iPadOS 17+), supporting a health-dashboard use case that tracks daily steps, heart rate, and workouts across devices.

Quick Start

Request authorization for the necessary HealthKit data types and fetch today's step count to populate your dashboard.

Frequently Asked Questions about healthkit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I request HealthKit authorization for reading and writing sample data in iOS 17?

HealthKit authorization requires requesting permissions for specific data types like stepCount and heartRate via a single HKHealthStore instance, enabling secure read and write operations while handling privacy on iOS 17+ and iPadOS 17+ devices.

Can I use async descriptors for HealthKit statistics and time-series queries?

Yes, HealthKit queries support async descriptors for statistics and time-series data retrieval. This approach modernizes sample data fetching and allows efficient health-data aggregation for dashboard implementations.

What's the best way to implement HealthKit background delivery for live workout metrics?

HealthKit background delivery integrates with HKWorkoutSession and HKLiveWorkoutBuilder to capture live workout metrics. Orchestrating these components enables continuous health-data tracking and live updates during active fitness sessions.

Does HealthKit integration require gating API availability for iPadOS 17 health dashboards?

Yes, HealthKit integration requires gating API availability to ensure features function correctly across iOS 17+ and iPadOS 17+ devices. This platform readiness check is essential before building health dashboards that track daily steps and heart rate.

Why should I reuse a single HKHealthStore instance for HealthKit data access?

Reusing a single HKHealthStore instance for HealthKit data access prevents resource leaks and ensures consistent authorization state. This production-grade pattern manages all health-data queries, background delivery, and workout session handling efficiently.