tooluniverse-drug-synergy — Claude Code skill
tooluniverse-drug-synergy quantifies whether two drugs act synergistically, additively, or antagonistically based on measured single-agent and combination effects.
Apache-2.0 127 installs ★ 1,798 updated 2026-10-24
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-drug-synergy -a claude-codeWhat tooluniverse-drug-synergy does
This skill determines whether a two-drug combination outperforms its additive expectation. Start by choosing a model that matches your data: single dose pair (Bliss), multiple dose points (HSA), full dose-response curves (Loewe or Combination Index), or dose × dose matrix (ZIP). Each model defines additivity differently — that's the null hypothesis against which synergy is measured.
Four main tools handle calculations: DrugSynergy_calculate_bliss for fast single-point screens, DrugSynergy_calculate_hsa for a conservative "does the combo beat the best monotherapy" test, DrugSynergy_calculate_loewe and DrugSynergy_calculate_ci for curve-based analysis, and DrugSynergy_calculate_zip for large matrices. Effects must use a single scale: fractional inhibition (0–1) for Bliss, HSA, Loewe, and CI. If your data is % viability, convert first using inhibition = 1 − viability/100. ZIP accepts % viability directly.
Synergy score is observed minus expected effect. For Bliss/HSA/Loewe/ZIP: score > +10 signals synergy, −10 to +10 is additive, < −10 is antagonism. Combination Index (Chou-Talalay) uses the opposite convention: CI < 1 is synergistic. Synergy is dose-dependent — a pair can be synergistic at one ratio and antagonistic at another. For matrix data, report the synergistic region, not a single value.
What it helps with
- determine if two drugs show synergy based on measured effects
- choose the right additivity model (Bliss, Loewe, HSA, or ZIP) for your data format
- convert % viability to fractional inhibition before calculation
- interpret synergy scores and compare across models
Example prompts for the agent
- Calculate Bliss synergy for drugs A and B: inhibition A=0.4, B=0.3, combination=0.7
- Apply HSA model to dose-effect arrays: A=[0.1, 0.3, 0.6], B=[0.2, 0.4, 0.65], combo=[0.5, 0.7, 0.9]
- Compute Chou-Talalay Combination Index from dose-response curves of drugs A and B plus one combination point
How to install tooluniverse-drug-synergy
1Skills CLI (Vercel)
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-drug-synergy -a claude-code2Manually: put the files in place
~/.claude/skills/tooluniverse-drug-synergy/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tooluniverse-drug-synergy/
1Skills CLI (Vercel)
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-drug-synergy -a codex2Manually: put the files in place
.agents/skills/tooluniverse-drug-synergy/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-drug-synergy -a cursor2Manually: put the files in place
.cursor/skills/tooluniverse-drug-synergy/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install mims-harvard/ToolUniverse skills/tooluniverse-drug-synergy2Manually: put the files in place
.github/skills/tooluniverse-drug-synergy/SKILL.md1Skills CLI (Vercel)
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-drug-synergy -a gemini-cli2Platform CLI
gemini skills install https://github.com/mims-harvard/ToolUniverse --path skills/tooluniverse-drug-synergyManually: put the files in place
.devin/skills/tooluniverse-drug-synergy/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-drug-synergy -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about tooluniverse-drug-synergy
How do I install tooluniverse-drug-synergy in Claude Code?
Run npx skills add mims-harvard/ToolUniverse --skill tooluniverse-drug-synergy -a claude-code, then open ~/.claude/skills/tooluniverse-drug-synergy/SKILL.md.
What does tooluniverse-drug-synergy do?
Calculates whether two drugs interact synergistically or antagonistically using measured effects. Supports five reference models (Bliss, HSA, Loewe, ZIP, Chou-Talalay) and selects the appropriate one based on your data structure.
What scales do the tools expect for drug effects?
Bliss, HSA, and Loewe expect fractional inhibition 0–1 (0 = no effect, 1 = complete inhibition). If you have % viability, convert: inhibition = 1 − viability/100. ZIP takes % viability as-is.
Source text
SKILL.md · Apache-2.0
---
name: tooluniverse-drug-synergy
description: Drug-combination synergy analysis — quantify whether two drugs together are synergistic, additive, or antagonistic using the standard reference models (Bliss independence, HSA / highest single agent, Loewe additivity, ZIP, and the Chou-Talalay Combination Index). Use when you have measured single-drug and combination effects (inhibition/viability) and need a synergy score. Explains which model to use, what data each one needs, and how to read the score. NOT for looking up pre-computed synergy in a database (use the SYNERGxDB tool / cell-line-profiling skill).
disable-model-invocation: true
---
# 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.
## Step 1 — What each model's "additivity" means
| Model | Null (additive) expectation | Best when |
|---|---|---|
| **Bliss independence** | drugs act independently: `E_exp = E_a + E_b − E_a·E_b` | different mechanisms; quick single-point screen |
| **HSA (highest single agent)** | combo should beat the *better* single agent: `E_exp = max(E_a, E_b)` | conservative "does it beat monotherapy?" question |
| **Loewe additivity** | a drug combined with itself = additive (dose equivalence) | same/similar mechanism; needs dose-response |
| **ZIP** | combines Bliss + Loewe; potency shift of one drug's curve by the other | dose-matrix screens (the SynergyFinder default) |
| **Chou-Talalay CI** | CI<1 synergy, =1 additive, >1 antagonism (median-effect) | classic isobologram-style analysis with dose-response |
There is no single "correct" model — **state which one you used.** Bliss and Loewe genuinely disagree for some combinations (that's expected, not an error); reporting two models (e.g. Bliss + HSA, or Loewe + ZIP) is good practice.
## Step 2 — Run it
```bash
# Bliss (single dose pair, fractional inhibition)
tu run DrugSynergy_calculate_bliss '{"operation":"calculate_bliss",
"effect_a":0.4,"effect_b":0.3,"effect_combination":0.7}'
# -> expected 0.58, bliss_synergy_score 0.12, "Strong synergy"
```
`scripts/synergy_reference.py` computes the Bliss, HSA, and Loewe-style expected combination effects side-by-side from one dose pair, so you can see at a glance whether the models agree before running the full tools.
## Step 3 — Interpret the score
For Bliss/HSA/Loewe/ZIP, the synergy score is `(observed − expected)` (often ×100):
| Score (fractional, ×100 scale) | Call |
|---|---|
| > +10 | synergy |
| −10 to +10 | additive (no meaningful interaction) |
| < −10 | antagonism |
For **Combination Index (Chou-Talalay)**: **CI < 1 = synergy**, CI = 1 additive, CI > 1 antagonism (note the opposite direction — lower is more synergistic).
- A positive Bliss/HSA score means the combination exceeds the additive expectation at that point.
- Synergy is often **dose-dependent** — a combination can be synergistic at one ratio and antagonistic at another; for a matrix, report the synergistic *region*, not one number.
## Step 4 — Gotchas (state these)
- **Scale mismatch** (% viability vs fractional inhibition) — convert first (Step 0).
- **Effects near 0 or 1 (ceiling).** If both single agents already kill ~everything, the combo can't show synergy (no headroom) — Bliss/HSA saturate; interpret with care.
- **ZIP/Loewe/CI need real dose-response** with ≥3 non-zero, measurable-effect dose points per drug, or the Hill fit fails (the tools say so).
- **Model disagreement is normal** — don't shop for the model that gives "synergy"; pre-specify the model and report it.
- **A synergy score is not efficacy** — a strongly synergistic combination can still be weak overall; report the absolute combination effect too.
## Honest limitations
- These are *reference-model* synergy scores, not statistical tests — for confidence, replicate and report variability across the dose matrix.
- Synergy in vitro does not guarantee clinical benefit (PK/PD, toxicity, scheduling all matter).
## Related skills
- `tooluniverse-dose-response` — fit the single-agent IC50/EC50 curves that Loewe/CI/ZIP need.
- `tooluniverse-cell-line-profiling` — look up *pre-computed* combination synergy (SYNERGxDB).
- `tooluniverse-drug-repurposing` / `tooluniverse-network-pharmacology` — rationale for combinations.
© mims-harvard · Apache-2.0 · mims-harvard/ToolUniverse