К основному содержанию
скилл CX Codex

tooluniverse-dose-response — скилл для Claude Code: анализ кривых

Скилл tooluniverse-dose-response для Claude Code подбирает 4PL-кривую по концентрациям и ответам, оценивает IC50 или EC50 и качество подгонки. Сравнивает активность соединений в лабораторных анализах.

Apache-2.0 128 установок ★ 1 798 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-dose-response -a claude-code
Открыть на GitHub

Что делает tooluniverse-dose-response

Скилл помогает обработать пары «концентрация — ответ» для ингибирования или активации. Он использует 4-параметрическую логистическую модель и получает IC50 или EC50, наклон Хилла, Emax, Emin и R². Для сравнения двух соединений рассчитывает сдвиг IC50 и указывает, какое активнее.

Перед расчётом нужно передать минимум 4 точки, концентрации — в линейной шкале и в одинаковых единицах. Кривая без плато на обоих концах даёт нестабильную, экстраполированную оценку; результаты такой подгонки нельзя уверенно трактовать. Модель 4PL не подходит для бипазных и колоколообразных кривых.

Для одного набора данных можно вызвать tu run DoseResponse_calculate_ic50; для сравнения предусмотрен инструмент DoseResponse_compare_potency. Скрипт scripts/fit_dose_response.py использует scipy и запускает подгонку из CSV. IC50 зависит от условий анализа, поэтому это не оценка Ki без поправки Cheng-Prusoff.

Какие задачи решает

  • оценить IC50 или EC50 по концентрациям и ответам
  • сравнить активность двух соединений
  • проверить качество подгонки кривой
  • получить наклон Хилла и плато Emax/Emin

Примеры запросов агенту

  • Рассчитай IC50 и наклон Хилла для этих концентраций и ответов; проверь качество кривой.
  • Сравни активность двух соединений по их концентрациям и ответам и укажи сдвиг IC50.

Как установить tooluniverse-dose-response

1Через Skills CLI (Vercel)

npx skills add mims-harvard/ToolUniverse --skill tooluniverse-dose-response -a claude-code

2Вручную: положить файлы

~/.claude/skills/tooluniverse-dose-response/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tooluniverse-dose-response/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о tooluniverse-dose-response

Как установить tooluniverse-dose-response в Claude Code?

Выполните npx skills add mims-harvard/ToolUniverse --skill tooluniverse-dose-response -a claude-code. Файл скилла находится по пути ~/.claude/skills/tooluniverse-dose-response/SKILL.md.

Что делает tooluniverse-dose-response?

Подгоняет 4-параметрическую логистическую кривую к данным концентраций и ответов. Выдаёт IC50 или EC50, параметры кривой и оценку качества подгонки.

Какие данные нужны для расчёта IC50?

Нужны минимум 4 пары концентрация—ответ. Концентрации следует передавать в линейной шкале, используя одинаковые единицы для всех точек.

Исходный текст

SKILL.md · Apache-2.0
---
name: tooluniverse-dose-response
description: Dose-response / concentration-response curve fitting — IC50, EC50, Hill slope, Emax/Emin efficacy, and relative potency from paired concentration vs response data (enzyme/cell assays, drug screening, agonist/antagonist pharmacology). Fits the 4-parameter logistic (Hill sigmoidal) model. Use when you have concentrations + responses and need a potency value, to compare two compounds' potency, or to judge curve quality. NOT for image-derived dose-response (use tooluniverse-image-analysis) and NOT for survival/regression (use tooluniverse-statistical-modeling).
disable-model-invocation: true
---

# Dose-Response / Concentration-Response Analysis

Turn paired **concentration vs response** measurements into a potency (IC50/EC50), a Hill slope, an efficacy (Emax), and a quality judgment — and compare potency between compounds.

## When to use this

- Enzyme inhibition / activation assays, cell viability, reporter assays, radioligand binding, agonist/antagonist pharmacology.
- You have a list of concentrations and the response at each, and want IC50/EC50 + Hill slope.
- You want to say "compound A is N-fold more potent than B."

The model is the 4-parameter logistic (4PL) / Hill sigmoidal:
`f(x) = Emin + (Emax − Emin) / (1 + (EC50/x)^n)` — where `n` is the Hill slope.

## Step 1 — Prepare the data (where results go wrong)

| Issue | What to do |
|---|---|
| **Concentration units** | Pick ONE unit (µM, nM, M) and use it for every point. The IC50 comes back in that unit. Don't mix. |
| **Log vs linear concentrations** | Pass concentrations on the **linear** scale (e.g. `0.01, 0.1, 1, 10`), not log10. The fitter logs internally. |
| **Zero/control concentration** | Drop a literal `0` concentration (log(0) is undefined). Keep it only as the Emin/Emax reference if normalizing. |
| **Direction** | Inhibition curves go high→low (IC50); activation curves go low→high (EC50). The tools handle both; just be consistent. |
| **Normalization** | Convert raw signal to % of control if you want Emax/Emin near 100/0: `% = 100 × (raw − blank)/(control − blank)`. Raw values also fit, but plateaus are then in raw units. |
| **Replicates** | Average technical replicates per concentration before fitting, or pass all points (the fit weights them equally). |

**Coverage requirement:** you need **≥4 points** (the tools require it) and ideally **6–8 spanning both plateaus** — points clearly above and clearly below the inflection. A curve that never plateaus gives an unreliable, extrapolated IC50 (see Step 4).

## Step 2 — Fit / get the potency

Single curve → IC50 or EC50 (same math; "IC50" for inhibition, "EC50" for activation):

```bash
tu run DoseResponse_calculate_ic50 '{"operation":"calculate_ic50",
  "concentrations":[0.001,0.01,0.1,1,10,100],
  "responses":[98,95,80,45,12,3]}'
```

Returns `ic50`, `ic50_95_confidence_interval`, `hill_slope`, `emax`, `emin`, `r_squared`, `log_ic50`.

Full 4PL parameters only → `DoseResponse_fit_curve` (same inputs). Two compounds → `DoseResponse_compare_potency` with `conc_a/resp_a/conc_b/resp_b` (returns each IC50 + `ic50_fold_shift_b_over_a` + `more_potent`).

For non-standard needs (constrained plateaus, weighting, plotting), `scripts/fit_dose_response.py` runs a scipy 4PL fit from a CSV and matches the tool.

## Step 3 — Interpret the four parameters

| Parameter | Meaning | Sanity check |
|---|---|---|
| **IC50 / EC50** | Concentration giving half-maximal effect — the potency. Lower = more potent. | Should fall *within* your tested range; if it's at/beyond an endpoint, the curve is incomplete (Step 4). |
| **Hill slope `n`** | Steepness / apparent cooperativity. ~1 = simple one-site. >1.5 = steep/positive cooperativity (or non-specific). <0.5 = shallow/multiple sites or heterogeneity. | A wildly large `|n|` (>4) usually means a bad fit or too few transition points, not real cooperativity. |
| **Emax** | Maximal response (top plateau) = efficacy. | For % data, full agonist ≈100; a **partial agonist** plateaus well below 100 even at saturating dose. |
| **Emin** | Bottom plateau (baseline/floor). | For % inhibition data, ≈0 for a complete inhibitor. |
| **r²** | Fit quality. | ≥0.95 good; <0.90 → inspect for outliers, wrong model, or incomplete curve before trusting the IC50. |

**Potency comparison:** report the **fold-shift** in IC50/EC50 (e.g. "A is 6.2× more potent than B"), and only call it meaningful if both fits are good (r²≥0.95) and the Hill slopes are comparable — a potency ratio between curves of very different slope is not a clean comparison.

## Step 4 — Quality gotchas (state these, don't hide them)

- **Incomplete curve / no plateau.** If responses don't flatten at both ends, Emax/Emin (and thus IC50) are extrapolated and unstable. Report the IC50 as "approximate / right-shifted of the tested range" and recommend wider concentrations.
- **<4–5 points or none near the inflection.** The fit can converge to a nonsense IC50 with a high r². Check that points actually bracket the IC50.
- **Biphasic / U-shaped data.** A single 4PL is wrong for hormesis or two-site behavior — the fit will look poor (low r²); flag it rather than forcing one IC50.
- **IC50 vs Ki.** IC50 depends on assay conditions (substrate/ligand concentration). Don't report IC50 as an affinity (Ki) without a Cheng-Prusoff correction.
- **Units.** The IC50 is only as correct as the concentration unit you fed in — always state the unit.

## Honest limitations

- 4PL assumes a monotonic sigmoid; it cannot describe biphasic, bell-shaped, or steep all-or-none responses.
- A confident IC50 from a poor or incomplete curve is the most common error — let r² and curve coverage gate how you report it.
- Potency (IC50/EC50) is not efficacy (Emax) — a more potent compound can be a weaker (partial) agonist; report both.

## Related skills
- `tooluniverse-image-analysis` — dose-response on image-derived measurements (.tif, colony, fluorescence).
- `tooluniverse-gpcr-structural-pharmacology` / `tooluniverse-network-pharmacology` — receptor pharmacology context.
- `tooluniverse-statistical-modeling` — general regression, EC50 via spline, power analysis.

© mims-harvard · Apache-2.0 · mims-harvard/ToolUniverse

Похожие скиллы

Каталог скиллов SKILL.md →
gws-modelarmor-sanitize-response официальный googleworkspace Скилл gws-modelarmor-sanitize-response для Claude Code отправляет ответ модели в Google Model Armor на проверку по шаблону. Фильтрует текст перед показом пользователю. CX Codex +1 30 600установок nature-response Yuan1z0825 Скилл nature-response для черновиков, аудита и правки ответов на замечания рецензентов, сопроводительных писем и размеченных рукописей. CX Codex +1 16 700установок incident-response официальный anthropics Скилл incident-response ведёт инцидент от обнаружения до разбора: оценка серьёзности, статус-апдейты, хронология и blameless-постмортем. CX Codex +1 6 100установок legal-response официальный anthropics Скилл legal-response готовит ответы на типовые юридические запросы по шаблонам и проверяет ситуации, где нужен юрист. Подходит для DSR, NDA, vendor-вопросов и subpoena. CX Codex +1 3 600установок crisis-response-planner aaron-he-zhu Скилл crisis-response-planner собирает протокол кризисов в соцсетях: уровни серьёзности, паузу публикаций, библиотеку заявлений и порядок возврата к обычной работе. CX Codex +1 1 100установок review-response Galaxy-Dawn Скилл review-response разбирает комментарии рецензентов по классам и собирает структурированный ответ с опорой на артефакты статьи. Пригодится при подготовке rebuttal к конференции. CX Codex +1 568установок

Из того же набора136

Весь набор →
tooluniverse-residue-functional-mechanism-interpretation Скилл tooluniverse-residue-functional-mechanism-interpretation для Claude Code объясняет значимость аминокислотных остатков по структуре белка, данным UniProt и опциональным свидетельствам DMS или SAE. CX Codex +1 140установок tooluniverse-mendelian-randomization Скилл tooluniverse-mendelian-randomization проверяет, вызывает ли один фактор другой (например, холестерин — болезнь сердца), используя генетические варианты как инструменты. CX Codex +1 137установок tooluniverse-primer-design Скилл tooluniverse-primer-design подбирает праймеры для PCR и qPCR, считает температуру плавления и проверяет олигонуклеотиды на димеры. CX Codex +1 131установок tooluniverse-diagnostic-test-evaluation Скилл tooluniverse-diagnostic-test-evaluation оценивает точность диагностических тестов и биомаркеров по таблице 2×2 или непрерывным шкалам. Рассчитывает чувствительность, специфичность, ROC AUC и байесовскую вероятность. CX Codex +1 129установок tooluniverse-enzyme-kinetics Скилл tooluniverse-enzyme-kinetics рассчитывает параметры ферментативной кинетики Михаэлиса — Ментен по экспериментальным точкам и определяет тип ингибирования. CX Codex +1 128установок tooluniverse-drug-synergy Скилл tooluniverse-drug-synergy вычисляет, действуют ли два препарата синергично, аддитивно или антагонистично. CX Codex +1 127установок tooluniverse-clinical-risk-scoring Скилл tooluniverse-clinical-risk-scoring для Claude Code, Codex, Cursor и других агентов считает валидированные клинические шкалы риска по данным конкретного пациента. CX Codex +1 125установок tooluniverse-product-safety-surveillance Скилл tooluniverse-product-safety-surveillance для поиска данных об побочных эффектах, отзывах и отзывах медицинских устройств, пищевых добавок, косметики, ветеринарных препаратов и дефицитов лекарств через openFDA. CX Codex +1 123установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой