patient-variation

Generate patient demographics reflecting real-world population diversity including age distribution, gender, race, ethnicity, language, marital status, identifiers, contacts, and deceased status. Use

SKILL.md

GitHub

Patient Variation

Generate data that reflects real-world population diversity:

  • AGE DISTRIBUTION: Include neonates (0–28 days), infants (1m–1y), pediatric (1–17y), adults (18–64y), and geriatric (65+). Weight age groups roughly: 5% neonates/infants, 15% pediatric, 55% adults, 25% geriatric. Adjust per clinical context.
  • GENDER & SEX: Use FHIR administrative gender (male, female, other, unknown). Include transgender patients where clinically relevant — use extensions for birth sex (us-core-birthsex) and gender identity (us-core-genderIdentity).
  • RACE & ETHNICITY (US Core): Populate US Core Race and Ethnicity extensions:
  • LANGUAGE & COMMUNICATION: Set Patient.communication with language codes (en, es, zh, vi, ko, tl, ar, fr, de, ru, pt, hi, etc.) and communication.preferred = True for primary language. Include patients with limited English proficiency (LEP).
  • MARITAL STATUS: Vary using http://terminology.hl7.org/CodeSystem/v3-MaritalStatus (A=Annulled, D=Divorced, M=Married, S=Single/Never Married, W=Widowed, etc.)
  • MULTIPLE IDENTIFIERS: Include MRN, SSN (fake), driver's license, insurance member ID. Use proper identifier systems:
  • CONTACT/NOK: Include Patient.contact for emergency contacts / next of kin with relationship codes (C=Emergency Contact, N=Next of Kin, E=Employer, etc.)
  • DECEASED PATIENTS: Some patients should have deceasedBoolean=True or deceasedDateTime set. Approximately 2–5% of a general patient cohort.
  • MULTIPLE BIRTH: Use multipleBirthBoolean or multipleBirthInteger for twins/triplets.