health-data

Query Apple Health SQLite data and export summaries as Markdown, JSON, or FHIR R4.

3|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/pinion05/skills --skill health-data
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: health-data
Source: https://github.com/pinion05/skills/tree/main/health-data
Command: npx skills add https://github.com/pinion05/skills --skill health-data

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Apple Health data is often siloed and requires manual queries to extract insights. This Skill enables querying a local Apple Health SQLite database and generating structured, exportable outputs to support health analysis and reporting.

Core Features & Use Cases

  • Query and summarize vitals, activity, sleep, and workouts from the local health.db (SQLite) with deterministic results.
  • Output formats include Markdown, JSON, and FHIR R4 bundles, suitable for reports, dashboards, or interoperability with health systems.
  • Use Case: A clinician or researcher wants a daily health snapshot and weekly trends for a cohort, stored as Markdown for reports or JSON for ingestion into analytics pipelines.

Quick Start

Run the daily summary in Markdown: python ~/.claude/skills/health-data/scripts/health_query.py daily --date 2025-11-29 View weekly trends in JSON: python ~/.claude/skills/health-data/scripts/health_query.py weekly --weeks 4 --format json For ad-hoc queries: python ~/.claude/skills/health-data/scripts/health_query.py query "SELECT * FROM workouts LIMIT 5"

Frequently Asked Questions about health-data

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

FAQPage Schema
How do I query and summarize Apple Health data from a local SQLite database?

You can query and summarize Apple Health data from a local SQLite database by running the included Python script, which analyzes vitals, activity, sleep, and workouts deterministically using only Python's standard library.

Can I export Apple Health data to FHIR R4 bundles for interoperability?

Yes, you can export Apple Health data to FHIR R4 bundles. The skill generates output in Markdown, JSON, and FHIR R4 formats, enabling interoperability with health systems and analytics pipelines.

How do I generate a daily health snapshot in Markdown from Apple Health data?

To generate a daily health snapshot in Markdown, run the Python script with the daily command and specify the target date. It summarizes vitals, activity, sleep, and workouts from the local health database.

Do I need to install external Python packages to analyze Apple Health data locally?

No, you do not need to install external Python packages to analyze Apple Health data locally. The skill relies entirely on Python's standard library to query the SQLite database and produce deterministic results.

What is the best way to extract weekly health trends into JSON format?

The best way to extract weekly health trends into JSON format is to run the Python script with the weekly command, specifying the number of weeks and the JSON output format for analytics pipeline ingestion.

Can I run ad-hoc SQL queries directly against my local health database?

Yes, you can run ad-hoc SQL queries directly against your local health database. The script supports a query mode that accepts standard SQL statements, such as selecting specific workout records with limits.