Skip to main content
skill CX Codex

tooluniverse-enzyme-kinetics — Claude Code skill

tooluniverse-enzyme-kinetics fits Michaelis-Menten enzyme kinetics from substrate-velocity experimental points and identifies inhibition modes.

Apache-2.0 128 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-enzyme-kinetics -a claude-code
Open on GitHub

What tooluniverse-enzyme-kinetics does

The skill applies non-linear regression to initial rate measurements across substrate concentrations. It returns Michaelis constant Km, maximal velocity Vmax, fit diagnostics R² and SSE, along with Lineweaver-Burk coordinates for visual inspection.

Turnover number kcat and catalytic efficiency kcat/Km require supplying total molar enzyme concentration. The included scripts/fit_michaelis_menten.py script reads experimental CSV files and executes that conversion. Given velocity series with and without an inhibitor, the tool computes Ki and distinguishes competitive, uncompetitive, or non-competitive modes.

Calculations assume single-substrate steady-state initial rates. Allosteric cooperativity or substrate inhibition breaks the standard model and leaves distinct patterns across residual plots.

What it helps with

  • fit Michaelis-Menten Km and Vmax via non-linear regression
  • classify inhibition mechanism and calculate Ki values
  • convert maximum reaction velocity into turnover number kcat
  • query published kinetic parameters inside the SABIO-RK database

Example prompts for the agent

  • Fit Michaelis-Menten kinetic parameters using my substrate concentrations and initial velocity points.
  • Identify the inhibition mode and calculate Ki from velocity curves measured with and without inhibitor.
  • Run scripts/fit_michaelis_menten.py on my kinetic data table and compute kcat given the enzyme concentration.

How to install tooluniverse-enzyme-kinetics

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/tooluniverse-enzyme-kinetics/SKILL.md

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

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about tooluniverse-enzyme-kinetics

How to install tooluniverse-enzyme-kinetics in Claude Code?

Run npx skills add mims-harvard/ToolUniverse --skill tooluniverse-enzyme-kinetics -a claude-code. The skill file installs to ~/.claude/skills/tooluniverse-enzyme-kinetics/SKILL.md.

What does tooluniverse-enzyme-kinetics do?

It processes measured substrate concentration and initial velocity pairs to compute kinetic constants, fit quality metrics, and inhibitor mechanisms.

Why does it favor non-linear fitting over double-reciprocal plots?

Lineweaver-Burk transformations distort experimental errors by over-weighting low substrate points. The skill computes both but relies on non-linear regression for final reported values.

Source text

SKILL.md · Apache-2.0
---
name: tooluniverse-enzyme-kinetics
description: Enzyme kinetics — Michaelis-Menten Km, Vmax, kcat (turnover), and kcat/Km (catalytic efficiency / specificity constant) from substrate-velocity data, plus inhibition-mechanism analysis (competitive / uncompetitive / non-competitive, Ki). Fits the MM equation by nonlinear regression (and reports Lineweaver-Burk for reference). Use when you have substrate concentrations and initial reaction velocities and need kinetic parameters or to classify an inhibitor. NOT for BRENDA database lookups of published constants (use the BRENDA tools).
disable-model-invocation: true
---

# Enzyme Kinetics (Michaelis-Menten)

Turn **substrate concentration vs initial velocity** data into Km, Vmax, kcat, and catalytic efficiency — and classify an inhibitor's mechanism.

The Michaelis-Menten model: `v = Vmax·[S] / (Km + [S])`.

## When to use this

- You measured initial reaction rates at several substrate concentrations.
- You need Km (substrate affinity), Vmax, kcat (turnover number), or kcat/Km.
- You have ±inhibitor velocity data and want to classify the inhibition mode + Ki.

For *published* kinetic constants (someone else's Km/kcat), use the BRENDA tools or `SABIO_RK_search_reactions` instead — this skill is for analyzing **your own measured** data.

### Looking up published constants instead of fitting your own (SABIO-RK)

`SABIO_RK_search_reactions` searches >200,000 literature-curated kinetic entries (Km, kcat, Vmax, Ki) by EC number, enzyme name, substrate, organism, or product — no authentication required. A second source alongside BRENDA; check both if a value seems off, since coverage and curation differ.

```
tu run SABIO_RK_search_reactions '{"ec_number":"1.1.1.1"}'
tu run SABIO_RK_search_reactions '{"enzyme_name":"hexokinase","organism":"Homo sapiens","limit":5}'
tu run SABIO_RK_search_reactions '{"substrate":"ethanol","limit":10}'
```

Verified live: EC 1.1.1.1 (alcohol dehydrogenase), hexokinase/Homo sapiens, and ethanol-substrate queries all return real `kinetic_laws` entries with `substrates`, `products`, `parameters`, `mechanism_type`, and `pubmed_id`. **Gotcha (verified live)**: a returned entry can list its `parameter_types` (e.g. `["concentration","Hill coefficient","S_half","Vmax"]`) while the actual `parameters` array is empty — the entry documents *which* kinetic parameters were characterized for that reaction, not necessarily their numeric values in every record; check `parameters` is non-empty before citing a specific number, and if empty, look at a different entry_id for the same reaction/organism.

## Step 1 — Prepare the data

| Issue | What to do |
|---|---|
| **Initial velocities, not endpoints** | `v` must be the *initial* rate (linear phase, <10% substrate consumed). Endpoint or plateaued rates give a wrong Km/Vmax. |
| **Substrate range must span Km** | Include `[S]` both well below and well above Km (ideally ~0.2×Km to ~5×Km). Points only above Km can't define Km; only below can't define Vmax. |
| **Units — be consistent** | One `[S]` unit (mM, µM) → Km comes back in that unit. One velocity unit. Keep them fixed. |
| **For kcat you need [E]** | kcat = Vmax / [E]total. The tool's "catalytic_efficiency" is Vmax/Km on the velocity scale; to get true kcat (per-second turnover) and kcat/Km, divide Vmax by the molar enzyme concentration yourself. |
| **≥5–7 points** | Few points → unstable fit. Spread them across the range, not clustered. |

## Step 2 — Fit Michaelis-Menten

```bash
tu run EnzymeKinetics_calculate '{"operation":"michaelis_menten",
  "substrate_concs":[0.1,0.25,0.5,1,2,5,10],
  "velocities":[8.5,18,32,52,72,90,98]}'
```

Returns a `nonlinear_fit` block (`Vmax`, `Km`, `R2`, `SSE`) **— use these as the answer**, a `lineweaver_burk` block (for reference only), `catalytic_efficiency` (Vmax/Km), and `predicted_velocities` + `residuals`.

> **Prefer the nonlinear fit, not Lineweaver-Burk.** The double-reciprocal (Lineweaver-Burk) linearization distorts error (it over-weights low-`[S]` points) and is only for visualization/sanity — never report its Km/Vmax as the final values. The tool gives both; cite `nonlinear_fit`.

`scripts/fit_michaelis_menten.py` does the same nonlinear fit from a CSV and converts Vmax→kcat→kcat/Km when you supply the enzyme concentration.

## Step 3 — Interpret

| Parameter | Meaning | Notes |
|---|---|---|
| **Km** | Substrate concentration at ½Vmax — *apparent affinity* (lower Km = tighter binding / higher affinity). | In the same units as `[S]`. Must lie inside your tested range to be trustworthy. |
| **Vmax** | Maximum velocity at saturating substrate. | Depends on [E]; not an intrinsic enzyme property. |
| **kcat** | Turnover number = Vmax/[E] (per second). | Requires the molar enzyme concentration; intrinsic to the enzyme. |
| **kcat/Km** | Catalytic efficiency / specificity constant. | The best single metric to compare enzymes or substrates; near ~10⁸–10⁹ M⁻¹s⁻¹ is diffusion-limited ("catalytically perfect"). |
| **R² / SSE** | Fit quality. | R²≥0.98 good; check `residuals` for systematic curvature (a pattern, not random scatter, means MM is the wrong model). |

## Step 4 — Inhibition mechanism

Provide velocities ±inhibitor to classify the mode:

```bash
tu run EnzymeKinetics_calculate '{"operation":"inhibition",
  "substrate_concs":[...],
  "velocities_no_inhibitor":[...],
  "velocities_with_inhibitor":[...],
  "inhibitor_conc":5, "inhibition_type":"competitive"}'
```

| Mechanism | Effect on apparent Km | Effect on Vmax | Signature |
|---|---|---|---|
| **Competitive** | ↑ (increases) | unchanged | inhibitor competes at the active site; beatable by more substrate |
| **Uncompetitive** | ↓ (decreases) | ↓ | inhibitor binds only the ES complex |
| **Non-competitive (mixed)** | ~unchanged (pure) / changes (mixed) | ↓ | binds enzyme and ES; not relieved by substrate |

Ki is the inhibition constant (lower = more potent inhibitor). Decide the mechanism from how Km and Vmax shift, not from a single Lineweaver-Burk eyeball.

## Step 5 — Gotchas (state these)

- **Substrate inhibition** (velocity rises then *falls* at high `[S]`) breaks MM — the fit will show systematic residuals; flag it instead of forcing one Km.
- **Km outside the tested range** → unreliable; widen `[S]`.
- **kcat without [E]** is impossible — don't report a turnover number if you only fit velocities.
- **Lineweaver-Burk for final numbers** is the classic error — it's for a quick plot, not the reported Km/Vmax.

## Honest limitations

- MM assumes a single substrate, initial-rate, steady-state, one active site. Allosteric (sigmoidal) enzymes need the Hill equation; multi-substrate enzymes need their own formalism.
- Parameters are only as good as the substrate range and the initial-rate measurement.

## Related skills
- `tooluniverse-dose-response` — IC50/EC50 (the Hill/4PL sibling for concentration-response).
- `tooluniverse-statistical-modeling` — general nonlinear regression and model comparison.
- BRENDA tools / `SABIO_RK_search_reactions` — look up *published* enzyme kinetic constants.

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

Similar skills

All skills for Science and research →
cantera K-Dense-AI Runs Cantera homogeneous ideal-gas reactors and computes ignition delay with conservation diagnostics. Useful for combustion kinetics under constant-volume or constant-pressure states. CX Codex +1 465installs rhea-skill official OpenAI Sends compact search queries to the Rhea database and returns concise summaries for biochemical reactions, compounds, or reaction IDs. CX Codex GP ChatGPT +1 14installs react18-enzyme-to-rtl official github react18-enzyme-to-rtl provides Enzyme to React Testing Library migration patterns for React 18 upgrades. Useful when rewriting shallow renders, mount calls, and state assertions into user behavior checks. CX Codex +1 739installs Enzyme byenzyme Enzyme builds a local index over a folder of Markdown notes so your agent can pull up related entries from months of writing. Useful for Obsidian vaults. CX Codex +1 ★ 160repo stars last30days mvanhorn last30days is a Claude Code skill that finds recent discussion about a topic and gathers posts with engagement data. It can also diagnose broken or missing sources. CX Codex +1 64,200installs anysearch anysearch-ai The anysearch skill gives an agent web search, domain-specific queries, parallel batch search, and page extraction. Use it when a task needs current information or a claim needs checking. CX Codex +1 38,700installs academic-paper Imbad0202 This skill runs a 12-agent pipeline for academic paper writing in Claude Code. CX Codex +1 11,600installs nature-figure Yuan1z0825 nature-figure is a Claude Code skill that creates, revises, audits, and exports scientific figures in Python or R. It routes manuscript plots, multi-panel layouts, and requested AI-generated schematics to separate workflows. CX Codex +1 20,700installs

From the same set136

The whole set →
tooluniverse-mendelian-randomization The tooluniverse-mendelian-randomization skill tests whether one factor causally drives another (e.g., cholesterol → heart disease) using genetic variants as instrumental variables. CX Codex +1 137installs 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-drug-synergy tooluniverse-drug-synergy quantifies whether two drugs act synergistically, additively, or antagonistically based on measured single-agent and combination effects. CX Codex +1 127installs 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

Project sponsors

Companies that keep this analytics open