Agent skill
common
Install this agent skill to your Project
npx add-skill https://github.com/mark64oswald/healthsim-workspace/tree/main/skills/common
SKILL.md
Common Skills - Master Reference
Cross-product infrastructure skills that enable persistence, identity correlation, and database operations across all HealthSim products.
Quick Start
# Save your current work
Save this cohort as "demo-patients"
# Load previous work
Load the cohort named "demo-patients"
# Find related entities
Find the member record for patient MRN-12345
# Query the database
Show me all cohorts created in the last week
Core Capabilities
State Management
Persist generated data across sessions with cohort save/load operations. Supports auto-persist for token-efficient batch generation.
Triggers: save, load, persist, resume, snapshot, restore Details: state-management.md
Identity Correlation
Link entities across products using SSN as the universal correlator. Track the same person as patient, member, rx member, and trial subject.
Triggers: find member, link patient, correlate, same person, cross-reference Details: identity-correlation.md
DuckDB Operations
Direct database access for advanced queries, schema exploration, and reference data access.
Triggers: query, SQL, schema, database, show tables Details: duckdb-skill.md
Cross-Product Architecture
Common skills enable data flow between products:
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ PatientSim │ │ MemberSim │ │ RxMemberSim │
│ (MRN) │ │ (MBI) │ │ (RxID) │
└──────┬──────┘ └──────┬──────┘ └──────┬──────┘
│ │ │
└────────┬─────────┴─────────┬────────┘
│ │
┌──────▼───────┐ ┌───────▼──────┐
│ Identity │ │ State │
│ Correlation │ │ Management │
│ (SSN) │ │ (Cohorts) │
└──────────────┘ └──────────────┘
│ │
└─────────┬─────────┘
│
┌──────▼──────┐
│ DuckDB │
│ Database │
└─────────────┘
Database Schema
Common skills work with these core tables:
| Table | Purpose | Key Columns |
|---|---|---|
| cohorts | Saved cohort metadata | cohort_id, name, created_at |
| persons | Core person identity | person_id, ssn, demographics |
| patients | PatientSim entities | patient_id, mrn, person_id |
| members | MemberSim entities | member_id, mbi, person_id |
| rx_members | RxMemberSim entities | rx_member_id, rx_id, person_id |
Related Skills
- Generation Skills - Profile and journey building
- PopulationSim - Reference data and population targeting
- NetworkSim - Provider network modeling
Part of HealthSim Workspace Infrastructure
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
healthsim-rxmembersim
RxMemberSim generates realistic synthetic pharmacy data for testing PBM systems, claims adjudication, and drug utilization review. Use when user requests: (1) pharmacy claims or prescription data, (2) DUR alerts or drug interactions, (3) formulary or tier cohorts, (4) pharmacy prior authorization, (5) NCPDP formatted output.
healthsim-patientsim
Generate realistic clinical patient data including demographics, encounters, diagnoses, medications, labs, and vitals. Use when user requests: (1) patient records or clinical data, (2) EMR test data, (3) specific clinical cohorts like diabetes or heart failure, (4) HL7v2 or FHIR patient resources.
healthsim-trialsim
Generate realistic clinical trial synthetic data including study definitions, sites, subjects, visits, adverse events, efficacy assessments, and disposition. Use when user requests: clinical trial data, CDISC/SDTM/ADaM datasets, trial cohorts (Phase I/II/III/IV), FDA submission test data, or specific therapeutic areas like oncology or biologics/CGT.
healthsim-membersim
MemberSim generates realistic synthetic claims and payer data for testing claims processing systems, payment integrity, and benefits administration.
healthsim-networksim
NetworkSim provides provider network intelligence using real NPPES data (8.9M providers). Use this skill for ANY request involving: (1) provider search by specialty or location, (2) facility search (hospitals, nursing homes, clinics), (3) NPI validation, (4) network adequacy assessment against CMS/NCQA standards, (5) healthcare desert identification, (6) provider density analysis, (7) network roster generation, (8) hospital or physician quality metrics, (9) cross-product provider assignment, (10) pharmacy network analysis.
healthsim-populationsim
PopulationSim provides population-level intelligence using public data sources. Use this skill for ANY request involving: (1) population demographics or profiles, (2) geographic health patterns or disparities, (3) social determinants of health (SDOH), (4) SVI or ADI analysis, (5) cohort definition or specification, (6) clinical trial feasibility, site selection, or enrollment projection, (7) service area analysis, (8) health equity assessment, (9) census data or ACS variables, (10) CDC PLACES health indicators.
Didn't find tool you were looking for?