Skip to main content
skill CX Codex

tooluniverse-data-integration-analysis — Claude Code skill guide

tooluniverse-data-integration-analysis connects statistical results like DEGs and GWAS hits with biological databases. Explains mechanisms behind p-values.

Apache-2.0 246 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-data-integration-analysis -a claude-code
Open on GitHub

What tooluniverse-data-integration-analysis does

This skill takes significant findings from computational experiments and maps them onto biological knowledge bases. Rather than giving theoretical advice, the agent executes Python code directly via Bash, relying on pandas, scipy, statsmodels, or matplotlib. Data retrieval relies on ToolUniverse connections to resources such as UniProt, GO, Reactome, ClinVar, and OpenTargets.

The workflow guides the agent through structured evidence integration. It formulates mechanistic questions, pulls network interactions from STRING or BioGRID, assigns evidence confidence tiers from T1 to T4, and evaluates causality using DAGs, triangulation, and Mendelian randomization principles.

All tool queries must use English terms for genes, chemicals, and phenotypes regardless of conversation language. The skill does not compute primary statistics from raw sequencing reads; users need separate tools for initial DESeq2 or regression runs.

What it helps with

  • annotate significant gene lists with biological pathways
  • check variant functional impact and disease links in ClinVar
  • structure causal DAGs to identify confounders and mediators
  • grade evidence across independent literature and genetic datasets

Example prompts for the agent

  • Interpret the biological mechanism behind these top differential expression hits
  • Query OpenTargets and Reactome to contextualize our significant GWAS variants
  • Construct a causal DAG for this exposure-outcome association and check for mediators

How to install tooluniverse-data-integration-analysis

1Skills CLI (Vercel)

npx skills add mims-harvard/ToolUniverse --skill tooluniverse-data-integration-analysis -a claude-code

2Manually: put the files in place

~/.claude/skills/tooluniverse-data-integration-analysis/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tooluniverse-data-integration-analysis/

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

Questions about tooluniverse-data-integration-analysis

How to install tooluniverse-data-integration-analysis in Claude Code?

Run npx skills add mims-harvard/ToolUniverse --skill tooluniverse-data-integration-analysis -a claude-code in your terminal.

What does tooluniverse-data-integration-analysis do?

It integrates significant statistical findings with molecular databases to explain pathways, protein interactions, and disease relevance.

Does this skill perform differential expression calculations?

No, it expects precomputed statistical results. Run modeling or differential tests first, then pass significant hits here for biological context.

Source text

SKILL.md · Apache-2.0
---
name: tooluniverse-data-integration-analysis
description: Integrate computed statistical results (DEGs, GWAS hits, associations) with biological context from ToolUniverse databases (UniProt, GO, Reactome, ClinVar, OpenTargets). Use for adding gene function/pathway/disease annotations to a result list, building biological narrative around statistical findings, and going beyond p-values to mechanism.
disable-model-invocation: true
---

## COMPUTE, DON'T DESCRIBE
When analysis requires computation (statistics, data processing, scoring, enrichment), write and run Python code via Bash. Don't describe what you would do -- execute it and report actual results. Use ToolUniverse tools to retrieve data, then Python (pandas, scipy, statsmodels, matplotlib) to analyze it.

# Data Integration Analysis

Bridge the gap between statistical results and biological understanding. After any computational analysis produces significant findings, this skill teaches how to interpret them using ToolUniverse's biological knowledge tools -- the key advantage over platforms that only do data analysis.

**IMPORTANT**: Always use English terms in tool calls (gene names, pathway names, organism names), even if the user writes in another language. Respond in the user's language.

---

## When to Use This Skill

Apply when:
- Statistical analysis produced a list of significant genes, variants, metabolites, or exposures
- Users want to go beyond p-values to understand WHY something is significant
- Combining computational results with published evidence
- Interpreting differential expression, GWAS hits, or association study results biologically
- Users ask "what does this result mean?" after running an analysis

**NOT for** (use other skills instead):
- Running the statistical analysis itself --> Use `tooluniverse-statistical-modeling` or `tooluniverse-rnaseq-deseq2`
- Pure gene enrichment without prior analysis --> Use `tooluniverse-gene-enrichment`
- Pure literature review --> Use `tooluniverse-literature-deep-research`
- Single variant interpretation --> Use `tooluniverse-variant-interpretation`

---

## Step 1: Statistical Results to Biological Questions

Map each type of significant finding to the right biological question:

| Finding Type | Biological Question | Tool Discovery Query |
|---|---|---|
| Significant gene list | What pathways are enriched? What functions converge? | `find_tools("gene enrichment pathway analysis")` |
| Significant variant (rsID) | What is the functional impact? Which gene is affected? | `find_tools("variant annotation functional impact")` |
| Significant exposure/chemical | What is the biological mechanism? Which pathways? | `find_tools("chemical gene pathway toxicology")` |
| Significant drug association | What is the molecular target? What is the MOA? | `find_tools("drug target mechanism action")` |
| Significant metabolite | Which metabolic pathway is perturbed? | `find_tools("metabolite pathway identification")` |

**Key principle**: Do not stop at "gene X is significant." Ask: significant in what context? Through what mechanism? With what downstream consequence?

---

## Step 2: Multi-Database Evidence Integration

For each significant finding, query multiple sources and synthesize. The pattern:

1. **Literature evidence**: Search PubMed/EuropePMC for published studies linking your finding to the phenotype. Look for meta-analyses and systematic reviews first.
2. **Genetic association evidence**: Query GWAS Catalog or OpenTargets to check whether genetic evidence independently supports the association.
3. **Pathway context**: Query KEGG, Reactome, or WikiPathways to place the finding in a biological pathway. Identify upstream regulators and downstream effectors.
4. **Interaction networks**: Query STRING or BioGRID for protein-protein interactions. Look for whether your significant genes cluster in the same network neighborhood.
5. **Clinical relevance**: Check ClinVar for variant clinical significance, DGIdb or ChEMBL for druggability, or ClinicalTrials.gov for ongoing interventions.

**Evidence grading** (grade each piece of evidence):

| Grade | Source Type | Example |
|---|---|---|
| T1 (Strong) | Randomized clinical trial, Mendelian randomization | "RCT showed drug X reduces outcome Y" |
| T2 (Moderate) | Large cohort study, GWAS with replication | "GWAS meta-analysis in 500k subjects" |
| T3 (Suggestive) | Case-control study, animal model | "Mouse knockout shows phenotype" |
| T4 (Hypothesis) | In silico prediction, pathway inference | "Network analysis suggests involvement" |

---

## Step 3: Causal Reasoning

Statistical association is not causation. Apply these reasoning frameworks:

**DAG construction**: Before interpreting, sketch the causal directed acyclic graph (DAG).
- Identify potential **confounders** (common causes of exposure and outcome) -- these must be adjusted for.
- Identify potential **mediators** (on the causal path) -- do NOT adjust for these if estimating total effect.
- Identify **colliders** (common effects) -- conditioning on colliders introduces bias.

**Triangulation**: The same finding supported by different methods with different biases strengthens causal inference.
- Observational association + Mendelian randomization + animal experiment = strong triangulated evidence
- If MR contradicts observational data, suspect confounding in the observational study

**Mendelian randomization logic**: Genetic variants (instruments) are assigned at conception, so they are not confounded by lifestyle or reverse causation. If a genetic variant that increases exposure X also increases disease Y, this supports X causing Y. Check instrument strength (F-statistic > 10), exclusion restriction (variant affects Y only through X), and pleiotropy (MR-Egger intercept).

**Mediation analysis**: If gene G is associated with both exposure and outcome, ask: does the exposure effect on outcome go through G? Use the finding's pathway context (Step 2) to propose mediators, then check if adjusting for the mediator attenuates the effect.

---

## Step 4: Cross-Validation

Before reporting a finding as robust, attempt to falsify it:

1. **Replication**: Search literature and datasets (DataCite, GEO, ArrayExpress) for independent datasets where the same finding can be tested. A finding that replicates in an independent cohort is much stronger.
2. **Biological plausibility**: Does the mechanism make biological sense? Check if animal or cell models support it (PubMed search for "[gene] knockout [phenotype]" or "[chemical] exposure [cell type]").
3. **Genetic support**: Check if GWAS evidence supports the direction of effect. If your analysis says gene X is protective but GWAS shows risk alleles increase X expression, there is a contradiction to resolve.
4. **Dose-response**: If available, check whether the effect increases with dose. A dose-response relationship strengthens causal inference.
5. **Negative controls**: If possible, test the same analysis on a finding where you expect no association. If the negative control also shows an association, suspect a methodological artifact.

---

## Step 5: Actionable Reporting

Structure the integrated report as follows:

### Evidence Summary Table
For each significant finding, produce one row:

| Finding | Statistical Evidence | Biological Mechanism | Literature Support | Genetic Support | Evidence Grade |
|---|---|---|---|---|---|
| Gene X upregulated | FDR=0.001, log2FC=2.3 | PI3K/AKT pathway | 12 papers, 2 RCTs | GWAS: rs123 (p=5e-8) | Strong |
| Variant rs456 | OR=1.4, p=2e-6 | Splicing disruption | 3 case reports | eQTL in GTEx | Moderate |

### Strength Assessment
- **Strong**: Statistical significance + biological mechanism + independent replication + genetic support
- **Moderate**: Statistical significance + biological mechanism + partial replication
- **Weak**: Statistical significance + plausible mechanism but no independent support
- **Suggestive**: Statistical trend + computational prediction only

### Knowledge Gaps and Next Steps
- Which findings lack replication? Propose specific datasets to test in.
- Which mechanisms are inferred but not experimentally validated? Propose experiments.
- Which findings have conflicting evidence? State the contradiction explicitly.
- Generate testable hypotheses: "If finding X is causal, then [experimental prediction]."

### Clinical or Public Health Implications
- State whether the finding is actionable now or requires further validation.
- If druggable, identify existing therapeutics and their development stage.
- If a biomarker, assess sensitivity/specificity for clinical utility.

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

Similar skills

All skills for Science and research →

From the same set136

The whole set →
tooluniverse-dataset-discovery tooluniverse-dataset-discovery is a Claude Code skill that finds research datasets and checks study designs and variables for scientific questions. CX Codex +1 254installs tooluniverse-toxicology tooluniverse-toxicology builds a toxicity picture for a drug or chemical: AOP mechanism, FAERS signals, FDA label warnings, CTD associations, EPA CompTox hazard data. CX Codex +1 250installs tooluniverse-drug-mechanism-research The tooluniverse-drug-mechanism-research skill follows a drug from its primary target through pathway changes to clinical outcomes. Use it for pharmacology research, target comparisons, and mechanism reports. CX Codex +1 250installs tooluniverse-regulatory-genomics tooluniverse-regulatory-genomics queries regulatory elements, transcription factor binding motifs, and predicts non-coding variant effects using genomic databases and deep learning models. CX Codex +1 247installs tooluniverse-admet-prediction The tooluniverse-admet-prediction Claude Code skill profiles drug candidates by ADMET properties. It helps discard compounds likely to fail before wet-lab work. CX Codex +1 245installs tooluniverse-data-wrangling tooluniverse-data-wrangling guides the agent to download and parse scientific datasets via Python in Bash when ToolUniverse tools return only metadata or truncate results. CX Codex +1 245installs tooluniverse-protein-structure-prediction tooluniverse-protein-structure-prediction predicts protein structures from amino acid sequences and gathers evidence to assess the models. Use it to examine a new protein or explore how a variant may affect its structure. CX Codex +1 245installs tooluniverse-chemical-sourcing tooluniverse-chemical-sourcing finds commercial chemical suppliers across ZINC, Enamine, eMolecules, and Mcule after validating structures via PubChem or ChEMBL. CX Codex +1 243installs

Project sponsors

Companies that keep this analytics open