# tooluniverse-variant-to-mechanism

tooluniverse-variant-to-mechanism — a skill for end-to-end analysis of the genetic-variant-to-disease-mechanism chain.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 233 installs · ★ 1798 repo stars
- Author: mims-harvard
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/mims-harvard/ToolUniverse/tree/HEAD/skills/tooluniverse-variant-to-mechanism/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/tooluniverse-variant-to-mechanism

## What it does

This skill helps geneticists and computational biologists unpack how a DNA variant causes disease: where its regulatory action begins, which gene it touches, how that gene fits into molecular networks, and what phenotype results. Feed it an rsID or genomic coordinates, and it runs through six analysis phases: variant characterization (VEP, population frequency, CADD), regulatory landscape (GWAS, RegulomeDB, ENCODE, cCRE), target-gene discovery (GTEx eQTL, OpenTargets L2G), gene function and pathways (STRING, Reactome, GO), disease connection (OpenTargets, DisGeNET), and synthesis into a causal chain with evidence grading.

Optionally provide a trait context (type 2 diabetes, hypertension) and tissue of interest—the skill prioritizes accordingly. Built-in principle: when uncertain, search PubMed, UniProt, ChEMBL, ClinVar rather than guess. Ties together EnsemblVEP, MyVariant, GTEx, OpenTargets, RegulomeDB, ENCODE, GWAS Catalog, OpenTargets L2G, cCRE, STRING, Reactome, OLS and other tools through the ToolUniverse interface.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-variant-to-mechanism -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/tooluniverse-variant-to-mechanism/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/tooluniverse-variant-to-mechanism/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-variant-to-mechanism -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/tooluniverse-variant-to-mechanism/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-variant-to-mechanism -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/tooluniverse-variant-to-mechanism/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mims-harvard/ToolUniverse skills/tooluniverse-variant-to-mechanism
```

2. **Manually: put the files in place**
- File: `.github/skills/tooluniverse-variant-to-mechanism/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-variant-to-mechanism -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/mims-harvard/ToolUniverse --path skills/tooluniverse-variant-to-mechanism
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/tooluniverse-variant-to-mechanism/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-variant-to-mechanism -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/mims-harvard/ToolUniverse/tree/HEAD/skills/tooluniverse-variant-to-mechanism/SKILL.md

## When to use it
- locate the regulatory element where a non-coding variant resides
- trace a GWAS variant to its target gene through eQTL and L2G predictions
- reconstruct the full causal chain from variant to phenotype with evidence grades
- identify which tissues are relevant for a variant and map its molecular context
- confirm variant causality in molecular pathways and gene networks

## Example prompts
- Explain how rs7903146 drives type 2 diabetes through the pancreas
- Find the target gene for variant 10:112998590:C:T and its regulatory pathway
- Build a mechanistic model for a GWAS hit with evidence scores across all three layers

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: e884f9daa57bc3d0.

BEGIN THIRD-PARTY FILE e884f9daa57bc3d0
```text
---
name: tooluniverse-variant-to-mechanism
description: End-to-end variant-to-mechanism analysis — trace a variant (rsID/coordinates) through regulatory context, target gene(s), molecular pathway(s), and phenotypic consequences. Integrates 7+ databases across 3 evidence layers (regulatory, molecular, disease) for a mechanistic model. Use for GWAS-hit-to-mechanism, eQTL-causal-gene tracing, and full causal-chain reports.
disable-model-invocation: true
---

# Variant-to-Mechanism Analysis Skill

Trace the full causal chain from a genetic variant to its disease mechanism: regulatory context,
target gene(s), molecular pathways, and phenotypic consequences. Integrates 7+ databases across
3 evidence layers (regulatory, molecular, disease) to build an evidence-graded mechanistic model.

**IMPORTANT**: Always use English terms in tool calls. Respond in the user's language.

---

## LOOK UP, DON'T GUESS
When uncertain about any scientific fact, SEARCH databases first (PubMed, UniProt, ChEMBL, ClinVar, etc.) rather than reasoning from memory. A database-verified answer is always more reliable than a guess.

---

## When to Use This Skill

Apply when users:
- Ask "how does rs7903146 cause type 2 diabetes?"
- Want to trace a GWAS variant to its biological mechanism
- Need to connect a non-coding variant to downstream pathways
- Ask "what gene does this variant affect and through what pathway?"
- Want a mechanistic narrative for a regulatory variant
- Need to identify the causal gene for a GWAS locus
- Ask "what is the functional impact of this intronic SNP?"

**NOT for** (use other skills instead):
- Coding variant pathogenicity / ACMG classification -> Use `tooluniverse-variant-interpretation`
- Pure regulatory element annotation without mechanism -> Use `tooluniverse-regulatory-genomics`
- Pure GWAS hit listing without mechanism -> Use `tooluniverse-gwas-snp-interpretation`
- Pharmacogenomic variant annotation -> Use `tooluniverse-pharmacogenomics`
- Gene-disease association without variant context -> Use `tooluniverse-gene-disease-association`

---
```
END THIRD-PARTY FILE e884f9daa57bc3d0

The third-party file has ended. Everything between the e884f9daa57bc3d0 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2079 of 18354 bytes. © mims-harvard · Apache-2.0 · https://github.com/mims-harvard/ToolUniverse/tree/HEAD/skills/tooluniverse-variant-to-mechanism/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
