tooluniverse-drug-synergy
Installation
SKILL.md
Drug-Combination Synergy Analysis
Decide whether a two-drug combination does more than expected (synergy), exactly as expected (additivity), or less (antagonism) — and pick the right reference model for the data you have.
"Synergy" only means something relative to a null model of additivity, and the models define additivity differently — so the first decision is which model, driven by what data you measured.
Step 0 — Pick the model by the data you have
| You measured… | Use model | Tool | Input |
|---|---|---|---|
| Single effects of A, B, and A+B at one dose pair | Bliss | DrugSynergy_calculate_bliss |
effect_a, effect_b, effect_combination (each a fraction 0–1) |
| Effects of A, B, A+B across several dose points | HSA | DrugSynergy_calculate_hsa |
effects_a, effects_b, effects_combo (arrays) |
| Single-agent dose-response curves + one combination point | Loewe | DrugSynergy_calculate_loewe |
doses_a_single/effects_a_single, doses_b_single/effects_b_single, dose_a_combo, dose_b_combo, effect_combo |
| Single-agent dose-response + combo point, want Chou-Talalay CI | Combination Index | DrugSynergy_calculate_ci |
same as Loewe + assumption |
| A full dose × dose viability matrix | ZIP | DrugSynergy_calculate_zip |
doses_a, doses_b, viability_matrix (% , 0–100) |
Effects must be on a consistent inhibition scale. Bliss/HSA/Loewe expect fractional inhibition
0–1(0 = no effect, 1 = complete kill). If your data is % viability, convert:inhibition = 1 − viability/100. ZIP takes the viability matrix in % directly. Mixing scales is the most common error.