healthsim-populationsim

Creates data-driven population profiles and cohort specifications for HealthSim synthetic data generation.

1|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/mark64oswald/healthsim-agent --skill healthsim-populationsim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: healthsim-populationsim
Source: https://github.com/mark64oswald/healthsim-agent/tree/main/skills/populationsim
Command: npx skills add https://github.com/mark64oswald/healthsim-agent --skill healthsim-populationsim

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides data-driven population intelligence to support realistic synthetic health data generation across HealthSim products, enabling consistent, provenance-rich outputs.

Core Features & Use Cases

  • PopulationProfile & ground-truth grounding: Generate county-, tract-, and metro-level population profiles by aggregating embedded data from Census ACS, CDC PLACES, SVI, and ADI to ground synthetic data in real-world distributions.
  • CohortDefinition capabilities: Create CohortSpecification objects that drive patient, member, and trial populations with demographics, clinical profiles, and SDOH parameters.
  • Geographic breadth & cross-product flow: Enable generation across counties, tracts, MSAs, and custom regions, feeding PatientSim, MemberSim, and TrialSim with provenance and validation metadata.
  • SDOH integration & provenance: Provide SDOH indicators (SVI, ADI, Z-codes) and data-source provenance to ensure reproducibility and auditability of generated outputs.

Quick Start

  • Profile a county to obtain a PopulationProfile and review embedded-data provenance.
  • Define a CohortSpecification for a targeted population (e.g., diabetics in a region) and validate demographic/SDOH constraints.
  • Generate cross-product outputs (patients, members, trials) by feeding PopulationProfile-derived parameters into downstream HealthSim components.

Frequently Asked Questions about healthsim-populationsim

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate synthetic health data grounded in real population demographics?

To generate synthetic health data grounded in real populations, aggregate embedded Census ACS, CDC PLACES, SVI, and ADI datasets into county, tract, or metro-level profiles to ensure outputs reflect real-world distributions.

How do I define a clinical cohort with SDOH parameters for synthetic trials?

Define a clinical cohort by creating a CohortSpecification object that targets specific populations using demographics, clinical profiles, and SDOH parameters like SVI, ADI, and Z-codes.

What is data provenance in synthetic population generation and why is it needed?

Data provenance in synthetic population generation tracks embedded data sources like CDC PLACES and ACS to ensure reproducibility and auditability of generated patient, member, and trial outputs.

Can I generate synthetic populations for custom geographic regions?

Yes, synthetic populations can be generated for custom regions alongside standard counties, tracts, and MSAs, feeding the derived geographic parameters into downstream patient, member, and trial generation workflows.

Does this synthetic data tool integrate with downstream patient and member simulators?

Yes, this synthetic data tool feeds PopulationProfile-derived parameters into downstream HealthSim components like PatientSim, MemberSim, and TrialSim, embedding validation metadata for cross-product workflows.

What are the limitations of using aggregated CDC PLACES and SVI data for cohort specification?

Using aggregated CDC PLACES and SVI data for cohort specification requires validating demographic and SDOH constraints to ensure synthetic populations accurately reflect the targeted real-world distributions.