home / skills / sidetoolco / org-charts / health-data

health-data skill

/skills/workflows/health-data

This skill analyzes personal health data and lab results to optimize protocols, track trends, and support informed medical decisions.

npx playbooks add skill sidetoolco/org-charts --skill health-data

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
6.5 KB
---
name: health-data-analysis
description: Specialized skill for analyzing personal health data, medical records, lab results, and supplement protocols. Use when working with health records, clinical data, lab values, or health optimization planning.
license: Proprietary
metadata:
  author: edescobar
  version: "1.0"
  privacy: personal-health-data
compatibility: Requires access to health/ directory and understanding of medical terminology
---

# Health Data Analysis

Specialized skill for managing and analyzing personal health data, medical records, and optimization protocols.

## When to use this skill

Use this skill when:
- Analyzing lab results and clinical data
- Reviewing health records (776 FHIR files available)
- Planning supplement protocols
- Tracking health metrics over time
- Interpreting medical reports
- Managing chronic conditions (Hashimoto's thyroiditis)
- Optimizing cardiovascular health
- Working with health data exports

## Data Sources

### Available Records
**Location**: `health/` directory (1.3GB)

**Contents**:
- 776 FHIR-formatted clinical records (2017-2025)
- 405 diagnostic reports (comprehensive lab history)
- 333 observations (vital signs, measurements)
- 18 medication requests (prescription history)
- Lab results in PDF format
- Apple Health export data
- Workout routes and fitness data

### Key Files
- `clinical-history-summary.md`: Overview of medical conditions
- `context.md`: Detailed health history and current protocols (30KB)
- `function-health-report-2025-09-17.md`: Functional health assessment
- `lab-values-2025-09-17.md`: Recent lab results
- `export.xml` and `export_cda.xml`: Complete health data exports

## Medical Context

### Primary Conditions

#### Hashimoto's Thyroiditis (2017-present)
- Autoimmune hypothyroidism
- Currently on levothyroxine 100 mcg
- TSH trending elevated (needs monitoring)
- TPO antibodies >900 IU/mL
- Requires careful supplement coordination

#### Cardiovascular Risk Management
- Elevated LDL-C (146 mg/dL)
- Homocysteine ~22.6 μmol/L (target <10)
- Active lipid management protocol
- Plant sterols, berberine, omega-3 supplementation

#### Other Conditions
- Kidney function monitoring (creatinine trending)
- Rosacea (facial and ocular)
- Mercury exposure (dietary)
- Parathyroid adenoma surveillance

## Current Protocols

### Supplement Regimen
Comprehensive protocol including:
- Thyroid support (selenium, myo-inositol)
- Cardiovascular support (omega-3, plant sterols, berberine)
- Methylation support (TMG, B-complex)
- Vitamins and minerals (D3, K complex, magnesium, zinc, copper)
- Hair health (Nutrafol Men)
- Cognitive support (L-theanine)

### Important Interactions
- **Levothyroxine timing**: Empty stomach, 45-60 min before food
- **Mineral separation**: ≥4 hours from levothyroxine
- **Biotin interference**: Stop Nutrafol 3-5 days before thyroid labs
- **Iodine monitoring**: Nutrafol contains 225 mcg (watch thyroid function)

### Dietary Approach
- Gluten-free Mediterranean diet
- Low-mercury fish emphasis
- 30-40g fiber daily
- Anti-inflammatory focus

## Analysis Guidelines

### Lab Result Interpretation
When analyzing labs:
1. Compare to reference ranges (provided in reports)
2. Track trends over time (historical data available)
3. Consider medication effects
4. Note supplement interactions
5. Flag concerning changes
6. Recommend timing for follow-up

### Trend Analysis
Use historical data to:
- Identify patterns in thyroid function
- Track cardiovascular markers
- Monitor kidney function changes
- Assess supplement efficacy
- Detect emerging issues early

### Protocol Optimization
When adjusting protocols:
1. Review current supplement list and timing
2. Check for interactions and overlaps
3. Consider lab results and trends
4. Align with medical provider recommendations
5. Document rationale for changes
6. Set follow-up monitoring schedule

## Data Privacy

**CRITICAL**: This skill handles sensitive personal health information
- Never share specific health data externally
- Keep analyses within secure environment
- Maintain HIPAA-level privacy standards
- Document access and usage appropriately

## Clinical Monitoring

### Key Metrics to Track

**Thyroid Function** (every 6-8 weeks initially):
- TSH (target 1-2.5 mIU/L)
- Free T4
- Free T3
- Thyroid antibodies (TPO, TgAb)

**Cardiovascular Risk** (8-12 weeks):
- Lipid panel (total chol, LDL, HDL, TG)
- ApoB (target <90 mg/dL)
- Homocysteine (target <10 μmol/L)
- hs-CRP (inflammation)
- Omega-3 index

**Kidney Function** (as needed):
- Creatinine
- eGFR
- Cystatin C
- BUN

**Nutritional Status** (quarterly):
- Vitamin D (target 40-60 ng/mL)
- B12
- Folate
- Ferritin

## Common Tasks

### Reviewing New Labs
1. Read lab report PDF or data
2. Extract key values
3. Compare to reference ranges
4. Check historical trends
5. Identify concerns or improvements
6. Recommend follow-up actions

### Protocol Adjustments
1. Review current protocol in `context.md`
2. Identify need for change (labs, symptoms, goals)
3. Research interactions and evidence
4. Propose specific changes with rationale
5. Update timing schedules if needed
6. Set monitoring plan

### Health Data Export Analysis
1. Parse FHIR XML files
2. Extract relevant observations
3. Create structured summaries
4. Identify patterns or anomalies
5. Generate visualizations if helpful

## Best Practices

### Evidence-Based Approach
- Reference clinical guidelines
- Use peer-reviewed research
- Consider functional medicine principles
- Balance optimization with safety
- Acknowledge limitations and uncertainty

### Clear Communication
- Use plain language for complex concepts
- Provide context for recommendations
- Explain clinical significance
- Include both numbers and interpretation
- Suggest next steps clearly

### Safety First
- Flag concerning values immediately
- Recommend medical consultation when appropriate
- Don't override provider recommendations
- Consider drug-supplement interactions
- Respect individual tolerance and preferences

## Resources

### Internal References
- `health/context.md`: Complete health history and protocols
- `health/clinical-history-summary.md`: Condition overview
- `health/clinical-records/`: 776 FHIR files
- Lab PDFs for specific results

### External Guidelines
- Thyroid management: ATA guidelines
- Cardiovascular risk: ACC/AHA guidelines
- Supplement safety: NIH databases
- Drug interactions: Clinical databases

## Related Skills
- Use for medical data analysis
- Combine with `note-management` for organizing health documentation
- Use `context-manager` for complex health optimization projects

Overview

This skill analyzes personal health data, medical records, lab results, and supplement protocols to support informed clinical and optimization decisions. It focuses on thyroid disease, cardiovascular risk, kidney function, and supplement interactions while preserving strict data privacy. Use it to generate clear, actionable summaries and monitoring plans based on historical trends and current labs.

How this skill works

The skill parses FHIR records, diagnostic PDFs, Apple Health exports, and structured summaries to extract observations, medications, and lab values. It compares results to reference ranges, plots trends, identifies concerning changes, and highlights potential drug–supplement interactions. Recommendations are framed with clinical context, monitoring intervals, and rationale for adjustments.

When to use it

  • Interpreting thyroid labs, antibodies, and levothyroxine effects
  • Assessing cardiovascular risk (lipids, ApoB, homocysteine, hs-CRP)
  • Reviewing new diagnostic reports or batches of FHIR files
  • Designing or optimizing supplement regimens with interaction checks
  • Tracking kidney function and nutritional status over time

Best practices

  • Always compare values to provided reference ranges and historical trends
  • Document rationale and monitoring schedule when proposing protocol changes
  • Respect levothyroxine timing and mineral separation to avoid interference
  • Flag urgent or out-of-range values for medical review immediately
  • Follow evidence-based guidelines and note limitations of interpretations

Example use cases

  • Summarize the last 5 years of thyroid function and recommend timing for the next labs
  • Evaluate lipid panel and homocysteine trend and propose evidence-based supplement adjustments
  • Parse a batch of FHIR files to produce a structured clinical timeline and medication history
  • Review supplement list for interactions with levothyroxine and suggest timing changes
  • Create a quarterly monitoring plan for kidney function and nutritional markers

FAQ

How is sensitive health data handled?

Analyses are intended to remain inside a secure environment with HIPAA-level privacy; never share specific health data externally.

Can this skill replace a clinician?

No. The skill supports interpretation and optimization but recommends medical consultation for diagnosis, urgent findings, and prescription changes.