tooluniverse-gwas-study-explorer

Compare GWAS studies, meta-analyze loci, and assess replication across cohorts.

1.7k|254|Updated Mar 3, 2025
One-click install
npx skills add https://github.com/mims-harvard/ToolUniverse --skill tooluniverse-gwas-study-explorer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tooluniverse-gwas-study-explorer
Source: https://github.com/mims-harvard/ToolUniverse/tree/main/plugins/tooluniverse/skills/tooluniverse-gwas-study-explorer
Command: npx skills add https://github.com/mims-harvard/ToolUniverse --skill tooluniverse-gwas-study-explorer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tooluniverse, scipy.

What problem does it solve?

Researchers evaluating a genetic association often need to know whether it replicates across independent GWAS studies and how consistent effect sizes are, but manually comparing studies in the GWAS Catalog and computing meta-analysis statistics is slow and error-prone.

Core Features & Use Cases

  • Study Comparison: Retrieve and compare all GWAS studies for a trait by sample size, ancestry, platform, and summary-statistics availability.
  • Locus Meta-Analysis: Pool per-study effect sizes with inverse-variance weighting and compute Cochran's Q and I² heterogeneity, with an honest descriptive fallback when effect sizes are unavailable.
  • Replication Assessment: Check whether discovery-cohort hits reach significance in an independent replication study and classify replication strength.
  • Use Case: Ask whether the TCF7L2 variant rs7903146 shows a consistent effect on type 2 diabetes across all published studies, and receive a combined p-value, heterogeneity interpretation, and forest-plot data.

Quick Start

Ask the agent to compare all GWAS studies for type 2 diabetes and meta-analyze the rs7903146 association across them.

Frequently Asked Questions about tooluniverse-gwas-study-explorer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compare GWAS studies for the same trait?

Use the compare_gwas_studies function with a trait name like type 2 diabetes to retrieve studies from the GWAS Catalog, filter by sample size and ancestry, and identify replicated versus novel loci. It returns a quality summary including total samples and ancestry diversity.

How to perform a meta-analysis of a SNP across GWAS studies?

Call meta_analyze_locus with an rsID and trait to fetch all associations for that SNP, then pool per-study betas using inverse-variance weighting. It reports a combined p-value plus Cochran's Q and I² heterogeneity statistics when effect sizes are available.

What happens when GWAS studies lack effect sizes for meta-analysis?

When associations lack a usable beta and confidence interval, no formal pooling is performed. The result is marked method descriptive, combined_beta and I² are None, and the reported p-value is simply the smallest reported p, not a meta-analytic one.

How do I interpret the I² heterogeneity statistic in GWAS meta-analysis?

I² below 25% indicates low heterogeneity suitable for fixed-effects models, 25-50% is moderate, 50-75% is substantial and favors random-effects, and above 75% suggests meta-analysis may be inappropriate. High values often reflect ancestry or phenotype differences.

Can I check if discovery GWAS hits replicate in another cohort?

Yes, assess_replication takes discovery and replication study accession IDs and checks each discovery locus for presence and significance in the replication study. It classifies each locus as strongly replicated, nominally replicated, or not replicated.

What data sources does GWAS study comparison use?

It uses the NHGRI-EBI GWAS Catalog API for study metadata and associations, and the Open Targets Genetics GraphQL API for credible sets, fine-mapping results, and variant allele frequencies. Both are accessed through ToolUniverse tools.