HealthSim - Synthetic Healthcare Data Generation
Overview
HealthSim generates realistic synthetic healthcare data through natural conversation. Rather than writing code or configuration files, describe what you need and Claude generates appropriate data.
Products:
| Product |
Domain |
What It Generates |
Status |
| PatientSim |
Clinical/EMR |
Patients, encounters, diagnoses, procedures, labs, vitals, medications |
Active |
| MemberSim |
Payer/Claims |
Members, professional claims, facility claims, payments, accumulators |
Active |
| RxMemberSim |
Pharmacy/PBM |
Prescriptions, pharmacy claims, formularies, DUR alerts, prior auths |
Active |
| TrialSim |
Clinical Trials |
Studies, sites, subjects, visits, adverse events, efficacy, CDISC output |
Active |
| PopulationSim |
Demographics/SDOH |
Population profiles, cohort specifications, health disparities, SVI/ADI analysis |
Active |
| NetworkSim |
Provider Networks |
Providers, facilities, pharmacies, networks, benefit structures |
Active |
Quick Start
Generate Clinical Data
Request: "Generate a 65-year-old diabetic patient with hypertension"
Claude will produce a patient with:
- Demographics (age 65, realistic name/address)
- Diagnoses (E11.9 Type 2 diabetes, I10 hypertension)
- Medications (metformin, lisinopril)
- Labs (A1C, BMP with values in expected ranges)
- Comorbidities (likely hyperlipidemia, possible obesity)
Generate Claims
Request: "Create a professional claim for an office visit"
Claude will produce:
- Claim header (provider NPI, member ID, service date)
- Service lines (CPT 99213/99214, charges)
- Diagnoses (ICD-10 codes)
- Adjudication (allowed, paid, patient responsibility)
Generate Pharmacy Data
Request: "Generate a pharmacy claim that triggers a drug interaction alert"
Claude will produce:
- Prescription details (NDC, quantity, days supply)
- Pharmacy claim (BIN, PCN, cardholder ID)
- DUR alert (DD code, clinical significance, recommendation)
- Claim response (approved with warning or rejected)
Scenario Skills
PatientSim Scenarios
Load these for clinical data generation:
| Scenario |
Use When |
Key Elements |
| ADT Workflow |
admission, discharge, transfer, patient movement |
A01/A02/A03 events, bed management, census |
| Diabetes Management |
diabetic, A1C, glucose, metformin, insulin |
Disease progression, medication escalation, complications |
| Heart Failure |
CHF, HFrEF, BNP, ejection fraction |
NYHA classification, GDMT therapy, decompensation |
| Chronic Kidney Disease |
CKD, eGFR, dialysis, nephrology |
CKD staging, progression, comorbidities |
| Sepsis/Acute Care |
sepsis, infection, ICU, critical |
Sepsis criteria, antibiotic protocols, ICU stay |
| Orders & Results |
lab order, radiology, ORM, ORU, results |
Orders, specimens, lab panels, radiology reports |
| ED Chest Pain |
chest pain, emergency, ACS, troponin |
Risk stratification, HEART score, workup |
| Elective Joint |
hip replacement, knee replacement, arthroplasty |
Pre-op, surgery, recovery, PT |
| Maternal Health |
pregnancy, prenatal, L&D, postpartum |
Prenatal visits, GDM, preeclampsia, delivery |
| Oncology |
cancer, tumor, chemotherapy, breast/lung/colorectal |
Staging, treatment protocols, tumor markers |
See: skills/patientsim/ for detailed skills
MemberSim Scenarios
Load these for claims and payer data:
| Scenario |
Use When |
Key Elements |
| Plan & Benefits |
plan, benefit plan, HMO, PPO, HDHP |
Plan types, cost sharing, pharmacy tiers |
| Enrollment & Eligibility |
enrollment, eligibility, 834, 270/271 |
Member add/term, coverage verification, QLE |
| Professional Claims |
office visit, 837P, physician claim |
E&M coding, place of service, adjudication |
| Facility Claims |
hospital, inpatient, 837I, DRG |
Revenue codes, DRG assignment, LOS |
| Prior Authorization |
prior auth, pre-cert, authorization |
Request/response workflow, approval criteria |
| Accumulator Tracking |
deductible, OOP, accumulator |
Year-to-date tracking, family vs individual |
| Value-Based Care |
quality measures, VBC, HEDIS |
Attribution, measure compliance, incentives |
| Behavioral Health |
mental health, psychiatry, SUD, therapy |
Psychotherapy, medication management, PHP/IOP |
See: skills/membersim/ for detailed skills
RxMemberSim Scenarios
Load these for pharmacy and PBM data:
| Scenario |
Use When |
Key Elements |
| Retail Pharmacy |
prescription fill, retail, copay |
New/refill, pricing, patient pay |
| Specialty Pharmacy |
specialty drug, biologics, hub |
Limited distribution, PA, patient support |
| DUR Alerts |
drug interaction, DUR, therapeutic dup |
Alert types, severity, override |
| Formulary Management |
formulary, tier, coverage |
Tier structure, PA requirements, alternatives |
| Rx Enrollment |
rx enrollment, pharmacy member, BIN PCN |
Pharmacy benefit eligibility, plan assignment |
| Rx Prior Auth |
pharmacy PA, step therapy |
Clinical criteria, approval workflow |
| Rx Accumulators |
rx deductible, rx OOP, Part D phases |
Pharmacy cost sharing tracking, TrOOP |
| Manufacturer Programs |
copay card, patient assistance |
Copay cards, PAPs, hub services |
See: skills/rxmembersim/ for detailed skills
TrialSim Scenarios
Load these for clinical trial data generation:
| Scenario |
Use When |
Key Elements |
| Clinical Trials Domain |
trial concepts, phases, CDISC |
Phase definitions, regulatory, standards |
| Recruitment & Enrollment |
screening, enrollment, consent |
Screening funnel, I/E criteria, randomization |
| Phase 1 Dose Escalation |
Phase 1, FIH, MTD, 3+3, BOIN, CRM |
Dose escalation, DLT, PK sampling |
| Phase 2 Proof-of-Concept |
Phase 2, Simon's, MCP-Mod |
Futility stopping, dose-response |
| Phase 3 Pivotal |
Phase 3, pivotal, registration trial |
Multi-site, endpoints, safety monitoring |
| Oncology Trials |
oncology trial, tumor endpoints |
RECIST, survival endpoints, biomarkers |
| Cardiovascular Trials |
CV outcomes, MACE |
Cardiac events, biomarkers |
| CNS Trials |
CNS, Alzheimer's, MS |
Cognitive scales, imaging |
| Cell & Gene Therapy |
CAR-T, gene therapy, CGT |
Long-term follow-up, CRS, ICANS |
| Dimensional Analytics |
trial analytics, star schema, dashboard |
fact/dim tables, DuckDB, Databricks |
See: skills/trialsim/ for detailed skills
PopulationSim Scenarios
Load these for population intelligence and cohort definition:
| Scenario |
Use When |
Key Elements |
| Geographic Profile |
county profile, demographics for, MSA |
County/tract/metro demographics, health indicators |
| Health Patterns |
diabetes rate, prevalence, disparities |
CDC PLACES measures, age-adjusted rates |
| SDOH Analysis |
SVI, ADI, social vulnerability, deprivation |
SVI themes, ADI rankings, barriers |
| Cohort Definition |
define cohort, population segment |
CohortSpecification for generation products |
| Trial Support |
diversity planning, site selection, feasibility |
FDA diversity, site ranking, enrollment projections |
Key Differentiator: PopulationSim analyzes real population data (Census, CDC) and outputs specifications, not synthetic records. These specs drive realistic generation in PatientSim, MemberSim, and TrialSim.
See: skills/populationsim/ for detailed skills
NetworkSim Scenarios
Load these for provider network knowledge and entity generation:
| Scenario |
Use When |
Key Elements |
| Network Types |
HMO, PPO, EPO, POS, HDHP |
Network definitions, cost/flexibility tradeoffs |
| Plan Structures |
deductible, copay, coinsurance, OOP |
Benefit design, cost sharing, accumulators |
| Pharmacy Benefits |
tier structure, formulary, PBM |
Tier design, formulary types, pharmacy networks |
| PBM Operations |
BIN, PCN, claims processing, rebates |
Claim flow, adjudication, manufacturer rebates |
| Utilization Management |
prior auth, step therapy, QL |
PA process, step requirements, quantity limits |
| Specialty Pharmacy |
specialty drugs, hub model, REMS |
Limited distribution, specialty services |
| Network Adequacy |
access standards, time distance |
Time/distance, provider ratios, ECPs |
| Provider Generation |
generate provider, NPI, physician |
Synthetic providers with taxonomy, credentials |
| Facility Generation |
generate hospital, facility, CCN |
Synthetic facilities with beds, services |
| Pharmacy Generation |
generate pharmacy, NCPDP |
Synthetic pharmacies with type, chain |
See: skills/networksim/ for detailed skills
Generative Framework
Load these for batch generation and specification-driven data creation:
| Scenario |
Use When |
Key Elements |
| Profile Builder |
batch generation, cohort profile, population spec |
Demographics, conditions, coverage definitions |
| Journey Builder |
temporal patterns, event sequences, care pathways |
Timelines, triggers, branching |
| Quick Generate |
simple single-entity generation |
Fast single patient/member/claim |
| Distributions |
customize statistical patterns |
Age, cost, utilization distributions |
| Templates |
start from common patterns |
Pre-built profiles and journeys |
Key Differentiator: The Generative Framework enables specification-driven generation at scale. Build a profile, define a journey, then execute to generate hundreds or thousands of correlated entities across all products.
See: skills/generation/ for detailed skills
Common Skills
Cross-product infrastructure skills:
| Skill |
Use When |
Key Elements |
| State Management |
save scenario, load scenario, list scenarios |
DuckDB persistence, scenario naming |
| Identity Correlation |
link patient, find member, cross-product |
SSN correlation, entity linking |
| DuckDB Skill |
query database, SQL, schema |
Direct database operations |
See: skills/common/ for detailed skills
Output Formats
Default: JSON
By default, Claude outputs data as JSON objects that match the canonical data model.
Healthcare Standards
Request specific formats:
| Format |
Request Phrases |
Use Case |
| FHIR R4 |
"as FHIR", "FHIR bundle", "FHIR resources" |
Interoperability, modern APIs |
| C-CDA |
"as C-CDA", "as CCD", "discharge summary", "referral note" |
Clinical documents, HIE |
| HL7v2 |
"as HL7", "ADT message", "HL7v2" |
Legacy EMR integration |
| X12 834 |
"as 834", "X12 enrollment", "enrollment file" |
Benefit enrollment |
| X12 270/271 |
"as 270", "eligibility inquiry", "eligibility check" |
Eligibility verification |
| X12 837 |
"as 837", "X12 claim", "EDI format" |
Claims submission |
| X12 835 |
"as 835", "remittance", "ERA" |
Payment posting |
| NCPDP D.0 |
"as NCPDP", "pharmacy claim format" |
Pharmacy transactions |
| CDISC SDTM |
"as SDTM", "SDTM domains" |
Clinical trial regulatory submission |
| CDISC ADaM |
"as ADaM", "analysis datasets" |
Clinical trial statistical analysis |
See: formats/ for transformation skills
Analytics Formats
| Format |
Request Phrases |
Use Case |
| Dimensional (DuckDB) |
"star schema for DuckDB", "dimensional model", "for analytics" |
Local BI development |
| Dimensional (Databricks) |
"star schema for Databricks", "load to Databricks", "Unity Catalog" |
Enterprise analytics |
See: formats/dimensional-analytics.md for star schema details
Export Formats
| Format |
Request Phrases |
| CSV |
"as CSV", "save to CSV", "spreadsheet" |
| Parquet |
"as Parquet", "for analytics" |
| SQL INSERT |
"as SQL", "INSERT statements" |
Generation Parameters
Demographics
| Parameter |
Default |
Options |
| age_range |
18-90 |
Any range, e.g., "pediatric (0-17)", "senior (65+)" |
| gender |
weighted (49% M, 51% F) |
"male", "female", specific distribution |
| count |
1 |
Any number, batches for large counts |
Clinical (PatientSim)
| Parameter |
Options |
| conditions |
diabetes, heart failure, CKD, hypertension, COPD, etc. |
| severity |
mild, moderate, severe, well-controlled, poorly-controlled |
| complications |
with/without specific complications |
Claims (MemberSim)
| Parameter |
Options |
| claim_type |
professional, institutional, dental |
| claim_status |
paid, denied, pending, partial |
| network_status |
in-network, out-of-network |
Pharmacy (RxMemberSim)
| Parameter |
Options |
| fill_type |
new, refill |
| drug_type |
generic, brand, specialty |
| dur_alerts |
none, warning, reject |
Reproducibility
For consistent results across sessions:
Request: "Generate 10 patients using seed 42"
Claude will:
- Use seed 42 for all random selections
- Generate identical output if same parameters used
- Note the seed in output for reference
Validation
Claude automatically validates generated data for:
- Structural: Required fields, data types, formats
- Temporal: Date ordering (discharge after admission, etc.)
- Referential: Foreign key relationships
- Clinical: Age-appropriate conditions, gender-appropriate conditions
- Business: Valid code combinations, realistic pricing
Request explicit validation: "Validate this patient data"
Reference Data
For code lookups and documentation:
| Reference |
Description |
| Code Systems |
ICD-10, CPT, HCPCS, LOINC, NDC, RxNorm |
| Terminology |
Healthcare terminology and abbreviations |
| Clinical Rules |
Clinical business rules and guidelines |
| Validation Rules |
All validation rules and constraints |
| HL7v2 Segments |
HL7v2 segment definitions (MSH, PID, OBR, OBX, etc.) |
Format Transformations
Transform generated data to healthcare standards:
Healthcare Standards
| Format |
Skill |
Use Case |
| FHIR R4 |
formats/fhir-r4.md |
Modern interoperability, REST APIs |
| C-CDA |
formats/ccda-format.md |
CCD, Discharge Summary, clinical documents |
| HL7v2 ADT |
formats/hl7v2-adt.md |
Admit/Discharge/Transfer messages |
| HL7v2 ORM |
formats/hl7v2-orm.md |
Order messages (lab, rad, meds) |
| HL7v2 ORU |
formats/hl7v2-oru.md |
Results/observation messages |
| X12 837 |
formats/x12-837.md |
Claims submission (P/I) |
| X12 835 |
formats/x12-835.md |
Remittance/ERA |
| NCPDP D.0 |
formats/ncpdp-d0.md |
Pharmacy transactions |
Export Formats
| Format |
Skill |
Use Case |
| CSV |
formats/csv.md |
Spreadsheets, data analysis, bulk export |
| SQL |
formats/sql.md |
Database INSERT statements, data loading |
| Dimensional |
formats/dimensional-analytics.md |
Star schema for DuckDB, Databricks, BI tools |
Integration & Testing
| Guide |
Description |
| Integration Guide |
Cross-skill data flows and consistency |
| Testing Patterns |
Validation and test patterns |
Examples
Example 1: Simple Patient
Request: "Generate a patient"
Output:
{
"mrn": "MRN00000001",
"name": {
"given_name": "John",
"family_name": "Smith"
},
"birth_date": "1975-03-15",
"gender": "M",
"address": {
"street_address": "123 Main Street",
"city": "Springfield",
"state": "IL",
"postal_code": "62701"
}
}
Example 2: Clinical Scenario
Request: "Generate a 58-year-old female with poorly controlled Type 2 diabetes"
Output:
{
"patient": {
"mrn": "MRN00000002",
"name": { "given_name": "Maria", "family_name": "Garcia" },
"birth_date": "1967-08-22",
"gender": "F"
},
"diagnoses": [
{ "code": "E11.65", "description": "Type 2 diabetes with hyperglycemia" },
{ "code": "I10", "description": "Essential hypertension" },
{ "code": "E78.5", "description": "Hyperlipidemia" }
],
"medications": [
{ "name": "Metformin", "dose": "1000 mg", "frequency": "BID" },
{ "name": "Glipizide", "dose": "10 mg", "frequency": "BID" },
{ "name": "Lisinopril", "dose": "20 mg", "frequency": "QD" }
],
"labs": [
{ "test": "HbA1c", "value": "9.8", "unit": "%", "flag": "H" },
{ "test": "Glucose", "value": "245", "unit": "mg/dL", "flag": "H" },
{ "test": "Creatinine", "value": "1.2", "unit": "mg/dL" }
]
}
Example 3: Professional Claim
Request: "Generate a paid professional claim for an office visit"
Output:
{
"claim": {
"claim_id": "CLM20250115000001",
"claim_type": "PROFESSIONAL",
"member_id": "MEM001234",
"provider_npi": "1234567890",
"service_date": "2025-01-15",
"place_of_service": "11",
"principal_diagnosis": "E11.9",
"claim_lines": [
{
"line_number": 1,
"procedure_code": "99214",
"charge_amount": 175.00,
"units": 1
}
]
},
"adjudication": {
"status": "paid",
"allowed_amount": 125.00,
"paid_amount": 100.00,
"deductible": 0.00,
"copay": 25.00,
"coinsurance": 0.00
}
}
Example 4: Pharmacy Claim with DUR
Request: "Generate a pharmacy claim that gets rejected for early refill"
Output:
{
"claim": {
"claim_id": "RX20250115000001",
"transaction_code": "B1",
"ndc": "00071015523",
"drug_name": "Atorvastatin 20mg",
"quantity": 30,
"days_supply": 30,
"service_date": "2025-01-15"
},
"response": {
"status": "rejected",
"reject_code": "79",
"reject_message": "Refill Too Soon",
"dur_alert": {
"type": "ER",
"message": "Refill 12 days early (before 80% used)",
"previous_fill_date": "2024-12-27",
"days_early": 12
}
}
}
Tips
- Be specific: "diabetic patient with A1C of 9.5" beats "sick patient"
- Request format early: "Generate as FHIR..." rather than converting after
- Use seeds: For reproducible test data across sessions
- Batch large requests: "Generate 100 in batches of 20"
- Validate sensitive data: Request validation for production-like scenarios
Disclaimer
HealthSim generates synthetic test data only. It is not a clinical decision support system and does not provide medical advice, diagnosis recommendations, or treatment guidance.
Intended uses:
- Software development and testing
- System integration validation
- Training and educational demonstrations
- Performance and load testing
Not intended for:
- Clinical decision support
- Medical advice or treatment recommendations
- Actual patient care
- Processing real PHI
The clinical patterns, medication regimens, and lab values reflect general healthcare conventions suitable for test data. They do not account for individual patient circumstances or the full complexity of clinical practice.
1---2name: healthsim3description: "HealthSim generates realistic synthetic healthcare data for testing EMR systems, claims processing, pharmacy benefits, and analytics. Use for ANY request involving: (1) synthetic patients, clinical data, or medical records, (2) healthcare claims, billing, or adjudication, (3) pharmacy prescriptions, formularies, or drug utilization, (4) HL7v2, FHIR, X12, or NCPDP formatted output, (5) healthcare testing scenarios or sample data generation."4metadata:5 source: https://skillmd.com/skills/diegosouzapw/healthsim6---78# HealthSim - Synthetic Healthcare Data Generation910## Overview1112HealthSim generates realistic synthetic healthcare data through natural conversation. Rather than writing code or configuration files, describe what you need and Claude generates appropriate data.1314**Products:**1516| Product | Domain | What It Generates | Status |17|---------|--------|-------------------|--------|18| **PatientSim** | Clinical/EMR | Patients, encounters, diagnoses, procedures, labs, vitals, medications | Active |19| **MemberSim** | Payer/Claims | Members, professional claims, facility claims, payments, accumulators | Active |20| **RxMemberSim** | Pharmacy/PBM | Prescriptions, pharmacy claims, formularies, DUR alerts, prior auths | Active |21| **TrialSim** | Clinical Trials | Studies, sites, subjects, visits, adverse events, efficacy, CDISC output | Active |22| **PopulationSim** | Demographics/SDOH | Population profiles, cohort specifications, health disparities, SVI/ADI analysis | Active |23| **NetworkSim** | Provider Networks | Providers, facilities, pharmacies, networks, benefit structures | Active |2425## Quick Start2627### Generate Clinical Data2829**Request:** "Generate a 65-year-old diabetic patient with hypertension"3031Claude will produce a patient with:32- Demographics (age 65, realistic name/address)33- Diagnoses (E11.9 Type 2 diabetes, I10 hypertension)34- Medications (metformin, lisinopril)35- Labs (A1C, BMP with values in expected ranges)36- Comorbidities (likely hyperlipidemia, possible obesity)3738### Generate Claims3940**Request:** "Create a professional claim for an office visit"4142Claude will produce:43- Claim header (provider NPI, member ID, service date)44- Service lines (CPT 99213/99214, charges)45- Diagnoses (ICD-10 codes)46- Adjudication (allowed, paid, patient responsibility)4748### Generate Pharmacy Data4950**Request:** "Generate a pharmacy claim that triggers a drug interaction alert"5152Claude will produce:53- Prescription details (NDC, quantity, days supply)54- Pharmacy claim (BIN, PCN, cardholder ID)55- DUR alert (DD code, clinical significance, recommendation)56- Claim response (approved with warning or rejected)5758## Scenario Skills5960### PatientSim Scenarios6162Load these for clinical data generation:6364| Scenario | Use When | Key Elements |65|----------|----------|--------------|66| **ADT Workflow** | admission, discharge, transfer, patient movement | A01/A02/A03 events, bed management, census |67| **Diabetes Management** | diabetic, A1C, glucose, metformin, insulin | Disease progression, medication escalation, complications |68| **Heart Failure** | CHF, HFrEF, BNP, ejection fraction | NYHA classification, GDMT therapy, decompensation |69| **Chronic Kidney Disease** | CKD, eGFR, dialysis, nephrology | CKD staging, progression, comorbidities |70| **Sepsis/Acute Care** | sepsis, infection, ICU, critical | Sepsis criteria, antibiotic protocols, ICU stay |71| **Orders & Results** | lab order, radiology, ORM, ORU, results | Orders, specimens, lab panels, radiology reports |72| **ED Chest Pain** | chest pain, emergency, ACS, troponin | Risk stratification, HEART score, workup |73| **Elective Joint** | hip replacement, knee replacement, arthroplasty | Pre-op, surgery, recovery, PT |74| **Maternal Health** | pregnancy, prenatal, L&D, postpartum | Prenatal visits, GDM, preeclampsia, delivery |75| **Oncology** | cancer, tumor, chemotherapy, breast/lung/colorectal | Staging, treatment protocols, tumor markers |7677See: [skills/patientsim/](skills/patientsim/) for detailed skills7879### MemberSim Scenarios8081Load these for claims and payer data:8283| Scenario | Use When | Key Elements |84|----------|----------|--------------|85| **Plan & Benefits** | plan, benefit plan, HMO, PPO, HDHP | Plan types, cost sharing, pharmacy tiers |86| **Enrollment & Eligibility** | enrollment, eligibility, 834, 270/271 | Member add/term, coverage verification, QLE |87| **Professional Claims** | office visit, 837P, physician claim | E&M coding, place of service, adjudication |88| **Facility Claims** | hospital, inpatient, 837I, DRG | Revenue codes, DRG assignment, LOS |89| **Prior Authorization** | prior auth, pre-cert, authorization | Request/response workflow, approval criteria |90| **Accumulator Tracking** | deductible, OOP, accumulator | Year-to-date tracking, family vs individual |91| **Value-Based Care** | quality measures, VBC, HEDIS | Attribution, measure compliance, incentives |92| **Behavioral Health** | mental health, psychiatry, SUD, therapy | Psychotherapy, medication management, PHP/IOP |9394See: [skills/membersim/](skills/membersim/) for detailed skills9596### RxMemberSim Scenarios9798Load these for pharmacy and PBM data:99100| Scenario | Use When | Key Elements |101|----------|----------|--------------|102| **Retail Pharmacy** | prescription fill, retail, copay | New/refill, pricing, patient pay |103| **Specialty Pharmacy** | specialty drug, biologics, hub | Limited distribution, PA, patient support |104| **DUR Alerts** | drug interaction, DUR, therapeutic dup | Alert types, severity, override |105| **Formulary Management** | formulary, tier, coverage | Tier structure, PA requirements, alternatives |106| **Rx Enrollment** | rx enrollment, pharmacy member, BIN PCN | Pharmacy benefit eligibility, plan assignment |107| **Rx Prior Auth** | pharmacy PA, step therapy | Clinical criteria, approval workflow |108| **Rx Accumulators** | rx deductible, rx OOP, Part D phases | Pharmacy cost sharing tracking, TrOOP |109| **Manufacturer Programs** | copay card, patient assistance | Copay cards, PAPs, hub services |110111See: [skills/rxmembersim/](skills/rxmembersim/) for detailed skills112113### TrialSim Scenarios114115Load these for clinical trial data generation:116117| Scenario | Use When | Key Elements |118|----------|----------|--------------|119| **Clinical Trials Domain** | trial concepts, phases, CDISC | Phase definitions, regulatory, standards |120| **Recruitment & Enrollment** | screening, enrollment, consent | Screening funnel, I/E criteria, randomization |121| **Phase 1 Dose Escalation** | Phase 1, FIH, MTD, 3+3, BOIN, CRM | Dose escalation, DLT, PK sampling |122| **Phase 2 Proof-of-Concept** | Phase 2, Simon's, MCP-Mod | Futility stopping, dose-response |123| **Phase 3 Pivotal** | Phase 3, pivotal, registration trial | Multi-site, endpoints, safety monitoring |124| **Oncology Trials** | oncology trial, tumor endpoints | RECIST, survival endpoints, biomarkers |125| **Cardiovascular Trials** | CV outcomes, MACE | Cardiac events, biomarkers |126| **CNS Trials** | CNS, Alzheimer's, MS | Cognitive scales, imaging |127| **Cell & Gene Therapy** | CAR-T, gene therapy, CGT | Long-term follow-up, CRS, ICANS |128| **Dimensional Analytics** | trial analytics, star schema, dashboard | fact/dim tables, DuckDB, Databricks |129130See: [skills/trialsim/](skills/trialsim/) for detailed skills131132### PopulationSim Scenarios133134Load these for population intelligence and cohort definition:135136| Scenario | Use When | Key Elements |137|----------|----------|--------------|138| **Geographic Profile** | county profile, demographics for, MSA | County/tract/metro demographics, health indicators |139| **Health Patterns** | diabetes rate, prevalence, disparities | CDC PLACES measures, age-adjusted rates |140| **SDOH Analysis** | SVI, ADI, social vulnerability, deprivation | SVI themes, ADI rankings, barriers |141| **Cohort Definition** | define cohort, population segment | CohortSpecification for generation products |142| **Trial Support** | diversity planning, site selection, feasibility | FDA diversity, site ranking, enrollment projections |143144**Key Differentiator**: PopulationSim analyzes real population data (Census, CDC) and outputs specifications, not synthetic records. These specs drive realistic generation in PatientSim, MemberSim, and TrialSim.145146See: [skills/populationsim/](skills/populationsim/) for detailed skills147148### NetworkSim Scenarios149150Load these for provider network knowledge and entity generation:151152| Scenario | Use When | Key Elements |153|----------|----------|---------------|154| **Network Types** | HMO, PPO, EPO, POS, HDHP | Network definitions, cost/flexibility tradeoffs |155| **Plan Structures** | deductible, copay, coinsurance, OOP | Benefit design, cost sharing, accumulators |156| **Pharmacy Benefits** | tier structure, formulary, PBM | Tier design, formulary types, pharmacy networks |157| **PBM Operations** | BIN, PCN, claims processing, rebates | Claim flow, adjudication, manufacturer rebates |158| **Utilization Management** | prior auth, step therapy, QL | PA process, step requirements, quantity limits |159| **Specialty Pharmacy** | specialty drugs, hub model, REMS | Limited distribution, specialty services |160| **Network Adequacy** | access standards, time distance | Time/distance, provider ratios, ECPs |161| **Provider Generation** | generate provider, NPI, physician | Synthetic providers with taxonomy, credentials |162| **Facility Generation** | generate hospital, facility, CCN | Synthetic facilities with beds, services |163| **Pharmacy Generation** | generate pharmacy, NCPDP | Synthetic pharmacies with type, chain |164165See: [skills/networksim/](skills/networksim/) for detailed skills166167### Generative Framework168169Load these for batch generation and specification-driven data creation:170171| Scenario | Use When | Key Elements |172|----------|----------|--------------|173| **Profile Builder** | batch generation, cohort profile, population spec | Demographics, conditions, coverage definitions |174| **Journey Builder** | temporal patterns, event sequences, care pathways | Timelines, triggers, branching |175| **Quick Generate** | simple single-entity generation | Fast single patient/member/claim |176| **Distributions** | customize statistical patterns | Age, cost, utilization distributions |177| **Templates** | start from common patterns | Pre-built profiles and journeys |178179**Key Differentiator**: The Generative Framework enables **specification-driven generation** at scale. Build a profile, define a journey, then execute to generate hundreds or thousands of correlated entities across all products.180181See: [skills/generation/](skills/generation/) for detailed skills182183### Common Skills184185Cross-product infrastructure skills:186187| Skill | Use When | Key Elements |188|-------|----------|--------------|189| **State Management** | save scenario, load scenario, list scenarios | DuckDB persistence, scenario naming |190| **Identity Correlation** | link patient, find member, cross-product | SSN correlation, entity linking |191| **DuckDB Skill** | query database, SQL, schema | Direct database operations |192193See: [skills/common/](skills/common/) for detailed skills194195## Output Formats196197### Default: JSON198199By default, Claude outputs data as JSON objects that match the canonical data model.200201### Healthcare Standards202203Request specific formats:204205| Format | Request Phrases | Use Case |206|--------|-----------------|----------|207| **FHIR R4** | "as FHIR", "FHIR bundle", "FHIR resources" | Interoperability, modern APIs |208| **C-CDA** | "as C-CDA", "as CCD", "discharge summary", "referral note" | Clinical documents, HIE |209| **HL7v2** | "as HL7", "ADT message", "HL7v2" | Legacy EMR integration |210| **X12 834** | "as 834", "X12 enrollment", "enrollment file" | Benefit enrollment |211| **X12 270/271** | "as 270", "eligibility inquiry", "eligibility check" | Eligibility verification |212| **X12 837** | "as 837", "X12 claim", "EDI format" | Claims submission |213| **X12 835** | "as 835", "remittance", "ERA" | Payment posting |214| **NCPDP D.0** | "as NCPDP", "pharmacy claim format" | Pharmacy transactions |215| **CDISC SDTM** | "as SDTM", "SDTM domains" | Clinical trial regulatory submission |216| **CDISC ADaM** | "as ADaM", "analysis datasets" | Clinical trial statistical analysis |217218See: [formats/](formats/) for transformation skills219220### Analytics Formats221222| Format | Request Phrases | Use Case |223|--------|-----------------|----------|224| **Dimensional (DuckDB)** | "star schema for DuckDB", "dimensional model", "for analytics" | Local BI development |225| **Dimensional (Databricks)** | "star schema for Databricks", "load to Databricks", "Unity Catalog" | Enterprise analytics |226227See: [formats/dimensional-analytics.md](formats/dimensional-analytics.md) for star schema details228229### Export Formats230231| Format | Request Phrases |232|--------|-----------------|233| **CSV** | "as CSV", "save to CSV", "spreadsheet" |234| **Parquet** | "as Parquet", "for analytics" |235| **SQL INSERT** | "as SQL", "INSERT statements" |236237## Generation Parameters238239### Demographics240241| Parameter | Default | Options |242|-----------|---------|---------|243| **age_range** | 18-90 | Any range, e.g., "pediatric (0-17)", "senior (65+)" |244| **gender** | weighted (49% M, 51% F) | "male", "female", specific distribution |245| **count** | 1 | Any number, batches for large counts |246247### Clinical (PatientSim)248249| Parameter | Options |250|-----------|---------|251| **conditions** | diabetes, heart failure, CKD, hypertension, COPD, etc. |252| **severity** | mild, moderate, severe, well-controlled, poorly-controlled |253| **complications** | with/without specific complications |254255### Claims (MemberSim)256257| Parameter | Options |258|-----------|---------|259| **claim_type** | professional, institutional, dental |260| **claim_status** | paid, denied, pending, partial |261| **network_status** | in-network, out-of-network |262263### Pharmacy (RxMemberSim)264265| Parameter | Options |266|-----------|---------|267| **fill_type** | new, refill |268| **drug_type** | generic, brand, specialty |269| **dur_alerts** | none, warning, reject |270271## Reproducibility272273For consistent results across sessions:274275**Request:** "Generate 10 patients using seed 42"276277Claude will:2781. Use seed 42 for all random selections2792. Generate identical output if same parameters used2803. Note the seed in output for reference281282## Validation283284Claude automatically validates generated data for:285286- **Structural**: Required fields, data types, formats287- **Temporal**: Date ordering (discharge after admission, etc.)288- **Referential**: Foreign key relationships289- **Clinical**: Age-appropriate conditions, gender-appropriate conditions290- **Business**: Valid code combinations, realistic pricing291292Request explicit validation: "Validate this patient data"293294## Reference Data295296For code lookups and documentation:297298| Reference | Description |299|-----------|-------------|300| [Code Systems](references/code-systems.md) | ICD-10, CPT, HCPCS, LOINC, NDC, RxNorm |301| [Terminology](references/terminology.md) | Healthcare terminology and abbreviations |302| [Clinical Rules](references/clinical-rules.md) | Clinical business rules and guidelines |303| [Validation Rules](references/validation-rules.md) | All validation rules and constraints |304| [HL7v2 Segments](references/hl7v2-segments.md) | HL7v2 segment definitions (MSH, PID, OBR, OBX, etc.) |305306## Format Transformations307308Transform generated data to healthcare standards:309310### Healthcare Standards311312| Format | Skill | Use Case |313|--------|-------|----------|314| FHIR R4 | [formats/fhir-r4.md](formats/fhir-r4.md) | Modern interoperability, REST APIs |315| C-CDA | [formats/ccda-format.md](formats/ccda-format.md) | CCD, Discharge Summary, clinical documents |316| HL7v2 ADT | [formats/hl7v2-adt.md](formats/hl7v2-adt.md) | Admit/Discharge/Transfer messages |317| HL7v2 ORM | [formats/hl7v2-orm.md](formats/hl7v2-orm.md) | Order messages (lab, rad, meds) |318| HL7v2 ORU | [formats/hl7v2-oru.md](formats/hl7v2-oru.md) | Results/observation messages |319| X12 837 | [formats/x12-837.md](formats/x12-837.md) | Claims submission (P/I) |320| X12 835 | [formats/x12-835.md](formats/x12-835.md) | Remittance/ERA |321| NCPDP D.0 | [formats/ncpdp-d0.md](formats/ncpdp-d0.md) | Pharmacy transactions |322323### Export Formats324325| Format | Skill | Use Case |326|--------|-------|----------|327| CSV | [formats/csv.md](formats/csv.md) | Spreadsheets, data analysis, bulk export |328| SQL | [formats/sql.md](formats/sql.md) | Database INSERT statements, data loading |329| Dimensional | [formats/dimensional-analytics.md](formats/dimensional-analytics.md) | Star schema for DuckDB, Databricks, BI tools |330331## Integration & Testing332333| Guide | Description |334|-------|-------------|335| [Integration Guide](docs/integration-guide.md) | Cross-skill data flows and consistency |336| [Testing Patterns](docs/testing-patterns.md) | Validation and test patterns |337338## Examples339340### Example 1: Simple Patient341342**Request:** "Generate a patient"343344**Output:**345```json346{347 "mrn": "MRN00000001",348 "name": {349 "given_name": "John",350 "family_name": "Smith"351 },352 "birth_date": "1975-03-15",353 "gender": "M",354 "address": {355 "street_address": "123 Main Street",356 "city": "Springfield",357 "state": "IL",358 "postal_code": "62701"359 }360}361```362363### Example 2: Clinical Scenario364365**Request:** "Generate a 58-year-old female with poorly controlled Type 2 diabetes"366367**Output:**368```json369{370 "patient": {371 "mrn": "MRN00000002",372 "name": { "given_name": "Maria", "family_name": "Garcia" },373 "birth_date": "1967-08-22",374 "gender": "F"375 },376 "diagnoses": [377 { "code": "E11.65", "description": "Type 2 diabetes with hyperglycemia" },378 { "code": "I10", "description": "Essential hypertension" },379 { "code": "E78.5", "description": "Hyperlipidemia" }380 ],381 "medications": [382 { "name": "Metformin", "dose": "1000 mg", "frequency": "BID" },383 { "name": "Glipizide", "dose": "10 mg", "frequency": "BID" },384 { "name": "Lisinopril", "dose": "20 mg", "frequency": "QD" }385 ],386 "labs": [387 { "test": "HbA1c", "value": "9.8", "unit": "%", "flag": "H" },388 { "test": "Glucose", "value": "245", "unit": "mg/dL", "flag": "H" },389 { "test": "Creatinine", "value": "1.2", "unit": "mg/dL" }390 ]391}392```393394### Example 3: Professional Claim395396**Request:** "Generate a paid professional claim for an office visit"397398**Output:**399```json400{401 "claim": {402 "claim_id": "CLM20250115000001",403 "claim_type": "PROFESSIONAL",404 "member_id": "MEM001234",405 "provider_npi": "1234567890",406 "service_date": "2025-01-15",407 "place_of_service": "11",408 "principal_diagnosis": "E11.9",409 "claim_lines": [410 {411 "line_number": 1,412 "procedure_code": "99214",413 "charge_amount": 175.00,414 "units": 1415 }416 ]417 },418 "adjudication": {419 "status": "paid",420 "allowed_amount": 125.00,421 "paid_amount": 100.00,422 "deductible": 0.00,423 "copay": 25.00,424 "coinsurance": 0.00425 }426}427```428429### Example 4: Pharmacy Claim with DUR430431**Request:** "Generate a pharmacy claim that gets rejected for early refill"432433**Output:**434```json435{436 "claim": {437 "claim_id": "RX20250115000001",438 "transaction_code": "B1",439 "ndc": "00071015523",440 "drug_name": "Atorvastatin 20mg",441 "quantity": 30,442 "days_supply": 30,443 "service_date": "2025-01-15"444 },445 "response": {446 "status": "rejected",447 "reject_code": "79",448 "reject_message": "Refill Too Soon",449 "dur_alert": {450 "type": "ER",451 "message": "Refill 12 days early (before 80% used)",452 "previous_fill_date": "2024-12-27",453 "days_early": 12454 }455 }456}457```458459## Tips4604611. **Be specific**: "diabetic patient with A1C of 9.5" beats "sick patient"4622. **Request format early**: "Generate as FHIR..." rather than converting after4633. **Use seeds**: For reproducible test data across sessions4644. **Batch large requests**: "Generate 100 in batches of 20"4655. **Validate sensitive data**: Request validation for production-like scenarios466467## Disclaimer468469HealthSim generates **synthetic test data only**. It is not a clinical decision support system and does not provide medical advice, diagnosis recommendations, or treatment guidance.470471**Intended uses:**472473- Software development and testing474- System integration validation475- Training and educational demonstrations476- Performance and load testing477478**Not intended for:**479480- Clinical decision support481- Medical advice or treatment recommendations482- Actual patient care483- Processing real PHI484485The clinical patterns, medication regimens, and lab values reflect general healthcare conventions suitable for test data. They do not account for individual patient circumstances or the full complexity of clinical practice.