Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-drug-synergy -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/tooluniverse-drug-synergy/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tooluniverse-drug-synergy/

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

Similar skills

All skills for AI and ML →

From the same set136

The whole set →
tooluniverse-primer-design tooluniverse-primer-design designs PCR and qPCR primers, computes Tm and Ta, and screens oligonucleotides for hairpins and dimers. CX Codex +1 131installs tooluniverse-diagnostic-test-evaluation tooluniverse-diagnostic-test-evaluation evaluates diagnostic test and biomarker accuracy from 2×2 tables or continuous scores. Computes sensitivity, specificity, ROC AUC, and Bayesian post-test probability. CX Codex +1 129installs tooluniverse-dose-response tooluniverse-dose-response fits a 4PL curve to concentration-response measurements and estimates IC50 or EC50. Use it to compare compound potency or assess how well a curve fits. CX Codex +1 128installs tooluniverse-enzyme-kinetics tooluniverse-enzyme-kinetics fits Michaelis-Menten enzyme kinetics from substrate-velocity experimental points and identifies inhibition modes. CX Codex +1 128installs tooluniverse-clinical-risk-scoring tooluniverse-clinical-risk-scoring — a skill for Claude Code, Codex, Cursor and other agents that computes validated clinical risk scores from individual patient data. CX Codex +1 125installs tooluniverse-product-safety-surveillance tooluniverse-product-safety-surveillance is a skill that searches openFDA for adverse events, recalls, and safety reports on medical devices, supplements, cosmetics, veterinary drugs, and medication shortages. CX Codex +1 123installs tooluniverse-natural-product-dereplication tooluniverse-natural-product-dereplication determines whether a compound is a known microbial natural product, identifies the producing organism, and assigns its ChemOnt chemical class. CX Codex +1 120installs tooluniverse-peptide-target-deorphanization The tooluniverse-peptide-target-deorphanization skill maps a peptide sequence and phenotype to plausible protein targets. Use it when binding results conflict with the proposed target or differ across species. CX Codex +1 117installs

Project sponsors

Companies that keep this analytics open