tooluniverse-gwas-finemapping

Prioritize causal variants at GWAS loci using credible sets and locus-to-gene scores.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tooluniverse.

What problem does it solve?

GWAS identifies trait-associated genomic regions, but linkage disequilibrium makes it hard to pinpoint the actual causal variant — the lead SNP is often just the best-tagged marker, not the cause. This Skill applies statistical fine-mapping results (SuSiE, FINEMAP) and locus-to-gene (L2G) predictions from Open Targets Genetics and the GWAS Catalog to identify likely causal variants and their effector genes.

Core Features & Use Cases

  • Credible Set Analysis: Retrieve fine-mapped credible sets for a variant, gene, or entire GWAS study, with posterior probabilities indicating each variant's likelihood of being causal.
  • Locus-to-Gene Prioritization: Rank candidate effector genes by L2G score integrating distance, eQTL evidence, chromatin interactions, and functional annotations — avoiding the often-wrong 'nearest gene' assumption.
  • Validation Guidance: Generate experimental validation suggestions (CRISPR knock-in, reporter assays, colocalization) based on fine-mapping results.
  • Use Case: Ask which variant at the TCF7L2 locus is likely causal for type 2 diabetes, and receive the credible set, posterior probabilities, and top L2G gene predictions.

Quick Start

Ask the agent to fine-map rs7903146 and identify the likely causal variant and target gene at that locus.

Frequently Asked Questions about tooluniverse-gwas-finemapping

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

FAQPage Schema
How do I fine-map a GWAS locus to find the causal variant?

Query credible sets for the lead SNP or gene using OpenTargets_get_variant_credible_sets or gwas_search_snps. Variants with posterior probability above 0.5 are strong causal candidates; use functional annotations and eQTL evidence to break ties among variants in high LD.

What is the difference between a lead SNP and a causal variant?

The lead SNP has the most significant p-value but is often just the best-tagged variant on the genotyping array. The causal variant may be in perfect LD with it or be a non-coding regulatory variant, so always inspect the full credible set rather than assuming the lead SNP is causal.

What is an L2G score and how should I interpret it?

The locus-to-gene (L2G) score from Open Targets predicts which gene a variant affects by integrating distance, eQTL evidence, chromatin interactions, and functional annotations. Scores above 0.7 indicate high confidence, 0.5-0.7 moderate, and below 0.3 low confidence.

Why don't all GWAS variants have credible sets?

Fine-mapping requires full GWAS summary statistics, an LD reference panel, sufficient signal strength (p < 5e-8), and computational resources. Studies lacking summary statistics or fine-mapping in Open Targets will not return credible sets.

What are the limitations of statistical fine-mapping?

Fine-mapping accuracy depends on LD structure matching the study population, and broad LD blocks limit resolution. Bayesian methods also depend on priors about causal variant counts, and results provide candidates requiring experimental validation, not proof.