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

tooluniverse-pharmacokinetics — скилл для Claude Code: анализ PK

Скилл tooluniverse-pharmacokinetics для Claude Code рассчитывает фармакокинетические параметры по концентрациям препарата во времени. Анализирует профиль после дозы и биодоступность при IV- и пероральном введении.

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

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

Что делает tooluniverse-pharmacokinetics

Скилл выполняет некомпартментный анализ: рассчитывает Cmax, Tmax, AUC, период полувыведения, клиренс, объём распределения и MRT. Также он умеет подгонять однокамерную модель и вычислять абсолютную биодоступность по AUC и дозам для IV и перорального введения. Для расчёта нужны измеренные концентрации и время отбора проб после дозы.

Данные можно передать инструменту NCA_compute_parameters или обработать CSV локально скриптом scripts/nca_from_csv.py. Для биодоступности есть NCA_calculate_bioavailability. Единицы времени, концентрации и дозы нужно согласовать. При пероральном введении CL и Vd будут кажущимися величинами (CL/F и Vd/F), а не прямыми оценками. Анализ рассчитан на однократную дозу; для равновесного состояния рассматривают один интервал дозирования.

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

  • рассчитать Cmax, Tmax и AUC по профилю концентрации во времени
  • оценить период полувыведения по терминальному участку кривой
  • получить клиренс и объём распределения после внутривенной дозы
  • вычислить абсолютную биодоступность по данным IV и перорального введения
  • подогнать однокамерную модель к данным концентрации

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

  • Рассчитай фармакокинетические параметры по моим измерениям концентрации во времени после внутривенной дозы.
  • Вычисли абсолютную биодоступность по AUC и дозам для перорального и внутривенного введения.
  • Подгони однокамерную модель к профилю концентрации препарата.

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/tooluniverse-pharmacokinetics/SKILL.md

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

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

Вопросы о tooluniverse-pharmacokinetics

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

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

Что делает tooluniverse-pharmacokinetics?

Скилл анализирует измеренные концентрации препарата во времени и рассчитывает основные PK-параметры. Он также поддерживает однокамерную модель и расчёт абсолютной биодоступности.

Можно ли использовать его для расчёта CL по пероральным данным?

Да, но результат будет кажущимся клиренсом CL/F, поскольку при пероральном введении всасывание может быть неполным. Для прямой интерпретации CL нужны данные после внутривенного введения.

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

SKILL.md · Apache-2.0
---
name: tooluniverse-pharmacokinetics
description: Pharmacokinetic (PK) analysis of concentration-time data — non-compartmental analysis (NCA) for Cmax, Tmax, AUC (0-t and 0-∞), terminal half-life, clearance (CL), volume of distribution (Vd), MRT, and absolute bioavailability (F). Also one-compartment fitting. Use when you have plasma/serum drug concentrations over time after a dose and need PK parameters, or to compute bioavailability from IV + oral AUCs. NOT for ADMET property prediction from structure (use tooluniverse-admet-prediction).
disable-model-invocation: true
---

# Pharmacokinetic (PK) Analysis — Non-Compartmental Analysis

Turn a **concentration-vs-time** profile after a dose into the standard PK parameters, and compute **bioavailability** from IV + oral data. Non-compartmental analysis (NCA) is the model-independent workhorse used for most PK reporting.

## When to use this

- You have measured plasma/serum (or other matrix) drug concentrations at known times after a dose.
- You need Cmax/Tmax/AUC/half-life/clearance/Vd, or absolute bioavailability F.
- Comparing exposure (AUC, Cmax) between formulations, doses, or routes.

This is **measured-data** PK. For predicting ADMET properties from a chemical structure, use `tooluniverse-admet-prediction`.

## Step 1 — Prepare the concentration-time data

| Issue | What to do |
|---|---|
| **Units — be consistent** | One time unit (h), one concentration unit (mg/L or ng/mL), one dose unit (mg). Pass them as `time_unit`/`conc_unit`/`dose_unit`. CL and Vd come back in derived units (e.g. L/h, L). |
| **Route matters** | Set `route` to `iv` or `po`/oral. CL and Vd are only directly interpretable for **IV** data; from oral data they are **apparent** (CL/F, Vd/F) because absorption is incomplete. |
| **Include t=0** | For IV bolus include the t=0 (back-extrapolated) point; for oral the pre-dose value is usually 0. |
| **BLQ (below limit of quantification)** | Leading BLQs before the first measurable → treat as 0; BLQs in the terminal tail → drop them (don't set to 0, it corrupts the terminal slope). |
| **Sampling design** | You need enough late points to define the terminal phase (≥3 points clearly in the log-linear decline) or the half-life and AUC0-∞ are unreliable. |
| **Single vs multiple dose** | NCA here assumes a single dose. For steady-state, analyze one dosing interval (AUC0-τ) and say so. |

## Step 2 — Run NCA

```bash
tu run NCA_compute_parameters '{
  "times":[0,0.5,1,2,4,8,12,24],
  "concentrations":[0,2.5,4.8,6.1,4.2,2.1,1.0,0.2],
  "dose":100, "route":"iv",
  "dose_unit":"mg", "conc_unit":"mg/L", "time_unit":"h"}'
```

Returns `Cmax`, `Tmax`, `Clast`, `Tlast`, `AUC0_last`, `AUC0-inf`, `AUC_extrapolation_pct`, `lambda_z`, `t_half`, `r_squared_terminal_fit`, `clearance_CL`, `volume_distribution_Vd`, `MRT_iv`, with a `units` block. AUC uses the FDA/EMA **linear-up / log-down trapezoidal** method.

For a CSV profile (with BLQ handling), `scripts/nca_from_csv.py` computes the same parameters locally.

Other tools:
- `NCA_fit_one_compartment` — fit a 1-compartment model (k, V, CL) when you want a parametric model instead of NCA.
- `NCA_calculate_bioavailability` — absolute F from `auc_po`, `dose_po`, `auc_iv`, `dose_iv` (see Step 4).

## Step 3 — Interpret the parameters

| Parameter | Meaning | Notes / sanity |
|---|---|---|
| **Cmax / Tmax** | Peak concentration & time to peak — absorption rate/extent. | For IV bolus Cmax is at t=0; a later Tmax means absorption (oral) or distribution. |
| **AUC0-t / AUC0-∞** | Total exposure (area under the curve). The key exposure metric. | AUC0-∞ extrapolates the tail using `Clast/lambda_z`. |
| **AUC_extrapolation_pct** | % of AUC0-∞ that was extrapolated beyond the last point. | **>20% → AUC0-∞ (and anything derived from it) is unreliable**; report AUC0-last instead and note insufficient sampling. |
| **lambda_z / t_half** | Terminal elimination rate constant and half-life. | Trust only if `r_squared_terminal_fit` ≥ ~0.95 and ≥3 terminal points were used. |
| **CL** (clearance) | Volume cleared per time = `Dose/AUC0-∞` (IV). | From oral data this is **CL/F** (apparent). |
| **Vd** | Volume of distribution = `CL/lambda_z` (IV). | From oral data this is **Vd/F** (apparent). |
| **MRT** | Mean residence time. | Longer MRT = slower overall elimination. |

## Step 4 — Absolute bioavailability (F)

F needs the **same drug given both IV and orally** (ideally same subjects, dose-normalized):

```bash
tu run NCA_calculate_bioavailability '{"auc_po":35.0,"dose_po":200,"auc_iv":43.4,"dose_iv":100}'
```

`F = (AUC_po / Dose_po) / (AUC_iv / Dose_iv)`. Report as a fraction or %. F near 1 = well absorbed; low F = poor absorption or high first-pass metabolism. F > 1 signals a data/dosing error (recheck units and doses).

## Step 5 — Quality gotchas (state these)

- **Extrapolation >20%** → don't report AUC0-∞/CL/Vd as reliable; the profile wasn't followed long enough.
- **Bad terminal fit** (`r_squared_terminal_fit` < 0.9, or <3 tail points) → half-life is unreliable.
- **CL/Vd from oral data are apparent** (CL/F, Vd/F) — never present them as true clearance/volume without IV data.
- **Units** drive CL/Vd — a wrong conc unit silently scales them. Always check the returned `units` block.
- **Flip-flop kinetics** (absorption slower than elimination) makes the "terminal" slope reflect absorption, not elimination — suspect it when oral t½ ≫ IV t½.

## Honest limitations

- NCA is model-independent and robust but gives no mechanistic structure (no separate absorption/distribution rate constants) — use `NCA_fit_one_compartment` or population PK for that.
- AUC accuracy depends entirely on sampling density around Cmax and in the terminal phase.
- Single-dose assumptions; for steady state analyze one interval (AUC0-τ) and accumulation separately.

## Related skills
- `tooluniverse-admet-prediction` — predict ADME properties from structure (no measured data).
- `tooluniverse-dose-response` — IC50/EC50 potency from concentration-response (not time-course).
- `tooluniverse-statistical-modeling` — compare PK parameters across groups.

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

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

Каталог скиллов SKILL.md →
pkpd-modeling K-Dense-AI Скилл pkpd-modeling считает NCA, компартментные модели и метрики экспозиции по данным концентрация-время, а в отчёте фиксирует, на каких допущениях держатся цифры. CX Codex +1 1 200установок find-skills vercel-labs Скилл find-skills для Claude Code ищет скиллы по задаче и помогает выбрать, что установить. Он включается, когда нужно найти готовую возможность для агента. CX Codex +1 4 400 000установок frontend-design официальный anthropics Скилл frontend-design для Claude Code задаёт осмысленное визуальное направление для новых интерфейсов и редизайна. Помогает уйти от шаблонного UI. CX Codex +1 1 025 790установок agent-browser vercel-labs Скилл agent-browser для Claude Code управляет браузером по запросам на навигацию, заполнение форм и проверку веб-приложений. Агент также может запускать через него исследовательское тестирование и автоматизировать Electron-приложения. CX Codex +1 1 600 000установок design-taste-frontend Leonxlnx Скилл design-taste-frontend для Claude Code задаёт правила оформления и проверки сайтов. Подключается при создании или переделке страницы, а также при просьбе убрать шаблонный вид. CX Codex +1 802 600установок grill-me Matt Pocock Скилл grill-me проводит жёсткое интервью по плану или дизайну, чтобы найти пробелы и уточнить решения. Подойдёт перед началом разработки. CX Codex +1 1 424 476установок grill-with-docs Matt Pocock Скилл grill-with-docs проводит жёсткое интервью по плану или дизайну и по ходу создаёт ADR и глоссарий. Подойдёт перед началом сложной разработки. CX Codex +1 1 219 756установок

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

Весь набор →
tooluniverse-meta-analysis Скилл tooluniverse-meta-analysis для Claude Code объединяет результаты нескольких исследований, оценивает неоднородность и строит лесной график. Выполняет мета-анализ для систематических обзоров и повторённых экспериментов. CX Codex +1 146установок tooluniverse-protein-structural-annotation-pdb Скилл tooluniverse-protein-structural-annotation-pdb размечает аминокислотные остатки в структуре PDB по положению в интерфейсе, кармане лиганда или гидрофобном ядре. CX Codex +1 145установок tooluniverse-variant-predictor-dms-validation Скилл tooluniverse-variant-predictor-dms-validation сверяет оценки влияния мутаций белков с экспериментальными данными глубокого мутационного сканирования (DMS). Помогает понять, отражает ли модель реальный эффект на функцию. CX Codex +1 142установок tooluniverse-protein-lof-mechanism Скилл tooluniverse-protein-lof-mechanism синтезирует пять слоёв вычислительных данных — от AlphaMissense до DynaMut2 — чтобы предложить конкретный механизм, как миссенс-вариант приводит к потере функции белка. CX Codex +1 141установок tooluniverse-protein-sae-variant-interpretation Скилл tooluniverse-protein-sae-variant-interpretation объясняет механизм мутаций белка через разреженные автоэнкодеры ESMC-6B, показывая потерю или появление биологических признаков. CX Codex +1 140установок 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установок

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

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