wellally-tech_skill

Overview

This skill integrates multiple digital health data sources and connects them to the WellAlly.tech knowledge base to help users manage personal health data. It imports data from Apple Health, Fitbit, Oura Ring, or generic CSV/JSON files, standardizes records to a local JSON format, and surfaces targeted WellAlly.tech articles. The goal is actionable insights and recommended reading tied to observed health patterns.

How this skill works

The skill detects the data source from user input and runs the appropriate import routine (HealthKit XML/ZIP parsing, Fitbit/Oura API sync, or CSV/JSON field-mapped import). Imported records are validated, mapped to a consistent local schema, and saved to structured data paths (e.g., data/fitness, data/sleep). It analyzes aggregated metrics (blood pressure, sleep duration, steps, weight trends) and matches detected concerns to relevant WellAlly.tech knowledge-base articles, returning direct links and a recommendation report.

When to use it

• You want to import or sync health data from Apple Health, Fitbit, or Oura Ring.
• You have a CSV/JSON export from a device or app and need field mapping and normalization.
• You want personalized article recommendations based on your recent health metrics.
• You need a validation report showing import completeness and potential data issues.
• You want to consolidate multiple device streams into one local health profile.

Best practices

• Export Apple Health using the built-in Health app export and provide the ZIP for import to preserve timestamps.
• Use OAuth for Fitbit and Oura integrations to keep tokens secure and refreshable.
• Provide a clear CSV/JSON mapping configuration when importing custom files to ensure correct field alignment.
• Review import validation warnings and resolve missing timestamps or outliers before relying on recommendations.
• Periodically re-sync device data and rerun recommendations after significant changes in metrics.

Example use cases

• Import last 30 days of Fitbit activity and get article suggestions for improving recovery and sleep.
• Upload an Apple Health export and receive a report showing blood pressure trends plus hypertension resources.
• Sync Oura Ring data and receive recommendations on sleep hygiene and readiness-focused articles.
• Import a custom CSV from a gym tracker and map fields to local format for consolidated activity history.
• Run a recommendation report after weight trend shifts to get targeted nutrition and behavior-change articles.