Integrate and Analyze Digital Health Data

This skill integrates multiple digital health data sources and connects to the WellAlly.tech knowledge base, providing data import and knowledge reference for personal health management systems. It covers four core features: digital health data import from Apple Health (HealthKit export XML/ZIP parsing), Fitbit (OAuth2 API integration and CSV import), Oura Ring (API v2 sync), and generic CSV/JSON files with field mapping; WellAlly.tech knowledge base integration with a categorized article index (nutrition, fitness, sleep, mental health, chronic disease management), intelligent article recommendations based on user health data, and direct URL references to the platform; data standardization that converts external data to a local JSON format, intelligently maps fields across platforms, and validates completeness and accuracy; and intelligent article recommendations that analyze health status and match relevant articles to the user's actual conditions.

Its execution flow has four steps. Identifying user intent routes the request to data import, knowledge base query, personalized recommendations, or data management. The data import workflow determines the data source, reads it with the matching import function (readAppleHealthExport, fetchFitbitData, fetchOuraData, or readGenericFile with a mapping config), maps fields to the local schema (e.g. mapping Apple Health step records to a date/steps/source/device shape), validates required fields, types, and ranges, and generates an import report with per-metric record counts and a date range. The knowledge base query workflow identifies the topic, searches a local knowledge-base index file for matching category tags or keywords, and returns article title/URL/category/description results. The recommendation workflow reads the user's profile, blood pressure, sleep, and weight-history data, analyzes it for concerns (e.g. average blood pressure over 140/90, average sleep under 6 hours, an increasing weight trend) and good patterns (e.g. average daily steps over 8,000), then maps each concern to relevant articles via a fixed condition-to-article mapping (covering hypertension, diabetes, sleep deprivation, weight gain, and high stress) and produces a recommendation report.

Data sources supported: Apple Health (file import, XML/ZIP), Fitbit (API or CSV, OAuth2), Oura Ring (API, OAuth2), and generic CSV/JSON via field mapping - written to local files under data/profile.json, data/fitness/activities.json, data/fitness/heart-rate.json, data/sleep/sleep-records.json, and data/fitness/recovery.json. The knowledge base is organized into five category files (nutrition, fitness, sleep, mental health, chronic disease management). Security and privacy rules are explicit: no uploading data to external servers except for API sync, no hardcoding API credentials, no sharing user access tokens, all imported data stored locally only, OAuth credentials encrypted, and import only after explicit user authorization; data validation filters abnormal values (e.g. negative steps) and preserves source information. Error handling covers file-read failures (report the issue and suggest re-export), API call failures (report and fall back to CSV import), and data-validation failures (skip invalid records, log the count, continue with valid data). The skill's tool footprint is limited to Read, Grep, Glob, and Write, and it links to related commands /health-trend, /sleep, /diet, /fitness, and /profile. For performance it reads incrementally within a specified date range, deduplicates same-day records, and writes in batches, with support for resuming after an interruption.

Use when importing or normalizing health data from sources like Apple Health, Fitbit, Oura, or CSV/JSON exports; when connecting personal health data workflows to the WellAlly.tech knowledge base; or when the task involves data import, health-data management, or article recommendations driven by user health context. Do not expect knowledge base articles to be available offline - they are referenced by URL and require a network connection to view on the WellAlly.tech platform.

Inputs are Apple Health export files, Fitbit/Oura API credentials or CSV exports, or generic CSV/JSON files with a mapping config. Outputs are locally stored, standardized JSON health records, an import report with record counts and validation warnings, and either direct knowledge-base article links or a personalized recommendation report tied to detected health concerns. Imported data is appended to, not overwritten by, later imports, with automatic deduplication of matching records, and data from multiple platforms merges together into the same local files.

python scripts/import_apple_health.py ~/Downloads/apple_health_export.zip

Apple HealthKit, the Fitbit API, and the Oura Ring API, whose sync additionally covers sleep stages, readiness, and heart rate variability alongside the step, weight, heart-rate, and sleep data shared with Apple Health and Fitbit; and the WellAlly.tech knowledge base and blog.

Personal health management systems and their users who need to consolidate data from wearables and health apps into one local store and get context-aware article recommendations from the WellAlly.tech knowledge base, as well as developers extending the skill with new wearable integrations or knowledge-base categories via its documented integration-guide and import-script pattern.