sensorkit

Fetch time-ranged iOS and watchOS sensor samples with SensorKit authorization.

Updated May 10, 2026
One-click install
npx skills add https://github.com/FelixRauch/medat-figuren --skill sensorkit-felixrauch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sensorkit
Source: https://github.com/FelixRauch/medat-figuren/tree/main/.agents/skills/sensorkit
Command: npx skills add https://github.com/FelixRauch/medat-figuren --skill sensorkit-felixrauch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Sensorkit helps you access research-grade iOS and watchOS sensor data for approved studies, without relying on general-purpose sensor APIs, while ensuring you meet Apple entitlement and authorization requirements.

Core Features & Use Cases

  • Research-only sensor access: Collects ambient light, motion, device usage, keyboard metrics, media events, and health-related streams for studies that have been approved by Apple.
  • Per-sensor entitlement + user authorization: Requires the com.apple.developer.sensorkit.reader.allow entitlement and per-sensor Research Sensor & Usage Data consent.
  • Record and fetch time-ranged samples: Supports starting/stopping recording and fetching prior recorded data via SRSensorReader and SRFetchRequest, including device-specific fetches.
  • Study constraints & guardrails: Handles key operational constraints such as the 24-hour holding period for newly recorded data and the need for delegates to receive results.

Quick Start

Request SensorKit authorization for the specific sensors your approved study needs, then start recording and fetch results for a time range that is at least 24 hours old.

Frequently Asked Questions about sensorkit

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

FAQPage Schema
How do I fetch iOS and watchOS research sensor data for an approved study?

SensorKit requires the com.apple.developer.sensorkit.reader.allow entitlement, specific Info.plist usage descriptions, a privacy policy URL, and per-sensor user consent via the Research Sensor & Usage Data sheet before accessing any streams.

Why does my SensorKit fetch request return no data for recently recorded samples?

Yes, SensorKit supports multi-device fetching, allowing you to collect health-related streams, keyboard metrics, and motion data from both iPhone and Apple Watch using device-specific fetches via SRFetchRequest.

Do I need delegates to receive SensorKit recording and fetch results?

Yes, SensorKit relies on delegation-based callbacks to receive fetched sensor samples and manage the recording lifecycle, requiring you to implement delegate methods for handling ambient light, media events, and device usage data.

What is the best way to manage the SensorKit recording lifecycle for research sensors?

The best way to manage the recording lifecycle is using SRSensorReader to start and stop recording specific sensor streams, ensuring you only collect data for your approved study while respecting time-ranged fetching constraints.