
GWAS Study Explorer
FreeAnalyze and compare GWAS studies for genetic insights.
Free · Opens the source repo
What GWAS Study Explorer does
The GWAS Study Explorer skill is designed for researchers and data analysts focused on understanding the genetic basis of complex traits through genome-wide association studies (GWAS). This skill allows users to compare multiple GWAS studies for a specific trait, enabling a deeper understanding of genetic associations and their reproducibility across different cohorts. By leveraging data from the NHGRI-EBI GWAS Catalog and Open Targets Genetics, it provides a comprehensive framework for evaluating study quality, sample sizes, and the diversity of populations involved.
With this skill, users can perform meta-analyses, aggregating effect sizes and assessing statistical heterogeneity among studies. It also facilitates the identification of replicated versus novel findings, crucial for validating genetic associations. The skill emphasizes the importance of rigorous analysis by providing tools to evaluate statistical power and the quality of the data used in the studies, ensuring that users can make informed conclusions about genetic signals.
Researchers will find this skill particularly useful when investigating specific traits, such as type 2 diabetes, by allowing them to filter studies based on ancestry and sample size. The ability to assess replication rates and consistency of findings across different populations makes it an essential tool for anyone involved in genetic research. Additionally, the skill's focus on statistical methods, such as fixed-effects and random-effects models, ensures that users can appropriately analyze their data based on the level of heterogeneity present.
Overall, the GWAS Study Explorer skill equips users with the necessary tools to conduct thorough analyses of GWAS studies, making it invaluable for researchers aiming to enhance the reproducibility and reliability of genetic findings.
When to use it
Use this skill when you need to analyze GWAS data, perform meta-analyses, or assess replication of genetic associations.
When not to use it
This skill may not be suitable for exploratory data analysis without a specific trait focus or for studies lacking sufficient statistical detail.
What you can build with it
Comprehensive Trait Analysis
Search for and analyze all available GWAS data for a specific trait, filtering by sample size and ancestry.
Locus-Specific Meta-Analysis
Retrieve and analyze associations for a specific SNP to assess consistency across studies.
Replication Analysis
Identify which findings from a discovery cohort are replicated in independent samples, evaluating success rates.
How to install GWAS Study Explorer
View source1. Install with the skills CLI
npx skills add mims-harvard/tooluniverse/tooluniverse-gwas-study-explorer --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by mims-harvardGWAS Study Deep Dive & Meta-Analysis
Compare GWAS studies, perform meta-analyses, and assess replication across cohorts
Overview
The GWAS Study Deep Dive & Meta-Analysis skill enables comprehensive comparison of genome-wide association studies (GWAS) for the same trait, meta-analysis of genetic loci across studies, and systematic assessment of replication and study quality. It integrates data from the NHGRI-EBI GWAS Catalog and Open Targets Genetics to provide a complete picture of the genetic architecture of complex traits.
Key Capabilities
- Study Comparison: Compare all GWAS studies for a trait, assessing sample sizes, ancestries, and platforms
- Meta-Analysis: Aggregate effect sizes across studies and calculate heterogeneity statistics
- Replication Assessment: Identify replicated vs novel findings across discovery and replication cohorts
- Quality Evaluation: Assess statistical power, ancestry diversity, and data availability
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.
Domain Reasoning: Comparing Studies for the Same Trait
When comparing GWAS studies for the same trait, ask: do they replicate? The same lead SNPs appearing in independent studies is strong evidence of a true association. Different lead SNPs at the same locus may reflect LD differences between populations — they may tag the same causal variant. Different loci entirely may reflect different study designs, phenotype definitions, or population ancestry. Before concluding that a finding failed to replicate, check whether the SNP was even genotyped or imputed in the replication cohort.
LOOK UP DON'T GUESS: effect sizes, p-values, allele frequencies, and LD structure for specific loci. Do not assume a SNP present in one study is present in another — use gwas_get_associations_for_snp to retrieve cross-study data. Do not infer LD blocks from genomic proximity; use credible sets from Open Targets for fine-mapping results.
Use Cases
1. Comprehensive Trait Analysis
Scenario: "I want to understand all available GWAS data for type 2 diabetes"
Workflow:
- Search for all T2D studies in GWAS Catalog
- Filter by sample size and ancestry
- Extract top associations from each study
- Identify consistently replicated loci
- Assess ancestry-specific effects
Outcome: Complete landscape of T2D genetics with replicated findings and population-specific signals
2. Locus-Specific Meta-Analysis
Scenario: "Is the TCF7L2 association with T2D consistent across all studies?"
Workflow:
- Retrieve all TCF7L2 (rs7903146) associations for T2D
- Calculate combined effect size and p-value
- Assess heterogeneity (I² statistic)
- Generate forest plot data
- Interpret heterogeneity level
Outcome: Quantitative assessment of effect size consistency with heterogeneity interpretation
Honesty rule (important): A real inverse-variance meta-analysis needs each study's beta + 95% CI.
python_implementation.pyparses these from the GWAS Catalogbeta/or_value+rangefields and only then pools effect sizes and computes Cochran's-Q I². When the matched associations don't report usable effect sizes (common), it returnsmethod="descriptive",combined_beta=None,heterogeneity_i2=None, andcombined_p_value= the smallest reported p (not a pooled p) — do NOT present a descriptive result as a formal meta-analysis or invent an I².
3. Replication Analysis
Scenario: "Which findings from the discovery cohort replicated in the independent sample?"
Workflow:
- Get top hits from discovery study
- Check for presence and significance in replication study
- Assess direction consistency
- Calculate replication rate
- Identify novel vs failed replication
Outcome: Systematic replication report with success rates and failed findings
4. Multi-Ancestry Comparison
Scenario: "Are T2D loci consistent across European and East Asian populations?"
Workflow:
- Filter studies by ancestry
- Compare top associations between populations
- Identify shared vs population-specific loci
- Assess allele frequency differences
- Evaluate transferability of genetic risk scores
Outcome: Ancestry-specific genetic architecture with transferability assessment
Statistical Methods
Meta-Analysis Approach
This skill implements standard GWAS meta-analysis methods:
Fixed-Effects Model:
- Used when heterogeneity is low (I² < 25%)
- Weights studies by inverse variance
- Assumes true effect size is the same across studies
Random-Effects Model (recommended when I² > 50%):
- Accounts for between-study variation
- More conservative than fixed-effects
- Better for diverse ancestries or methodologies
Heterogeneity Assessment:
The I² statistic measures the percentage of variance due to between-study heterogeneity:
I² = [(Q - df) / Q] × 100%
where Q = Cochran's Q statistic
df = degrees of freedom (n_studies - 1)
Interpretation Guidelines:
- I² < 25%: Low heterogeneity → fixed-effects appropriate
- I² = 25-50%: Moderate heterogeneity → investigate sources
- I² = 50-75%: Substantial heterogeneity → random-effects preferred
- I² > 75%: Considerable heterogeneity → meta-analysis may not be appropriate
Sources of Heterogeneity
Common reasons for high I²:
- Ancestry differences: Different allele frequencies and LD structure
- Phenotype heterogeneity: Trait definition varies across studies
- Platform differences: Imputation quality and coverage
- Winner's curse: Discovery studies overestimate effect sizes
- Cohort characteristics: Age, sex, environmental factors
Recommendations:
- Perform subgroup analysis by ancestry
- Use meta-regression to investigate sources
- Consider excluding outlier studies
- Apply genomic control correction
Study Quality Assessment
Quality Metrics
The skill evaluates studies based on:
1. Sample Size:
- Power to detect associations (80% power requires n > 10,000 for OR=1.2)
- Precision of effect size estimates
- Ability to detect modest effects
2. Ancestry Diversity:
- Single-ancestry vs multi-ancestry
- Population stratification control
- Transferability of findings
3. Data Availability:
- Summary statistics available for meta-analysis
- Individual-level data vs summary-level
- Imputation quality scores
4. Genotyping Quality:
- Platform density and coverage
- Imputation reference panel
- Quality control measures
5. Statistical Rigor:
- Genome-wide significance threshold (p < 5×10⁻⁸)
- Multiple testing correction
- Replication in independent cohort
Quality Tiers
Tier 1 (High Quality):
- n ≥ 50,000
- Summary statistics available
- Multi-ancestry or large single-ancestry
- Imputed to high-quality reference
- Independent replication
Tier 2 (Moderate Quality):
- n ≥ 10,000
- Standard GWAS platform
- Adequate power for common variants
- Some data availability
Tier 3 (Limited):
- n < 10,000
- Limited power
- May miss modest effects
- Use with caution
Best Practices
Before Meta-Analysis
- Check phenotype consistency: Ensure studies measure the same trait
- Verify ancestry overlap: High heterogeneity expected if ancestries differ
- Harmonize alleles: Align effect alleles across studies
- Quality control: Exclude low-quality studies or associations
Interpreting Results
- Genome-wide significance: p < 5×10⁻⁸ (Bonferroni for ~1M independent tests)
- Replication threshold: p < 0.05 in independent cohort
- Direction consistency: Effect should be same direction across studies
- Heterogeneity: I² > 50% suggests caution in interpretation
Common Pitfalls
❌ Don't:
- Meta-analyze without checking heterogeneity
- Ignore ancestry differences
- Over-interpret nominal p-values
- Assume replication failure means false positive
✅ Do:
- Always report I² statistic
- Perform sensitivity analyses
- Consider ancestry-stratified analysis
- Account for winner's curse in discovery studies
Limitations & Caveats
Data Limitations
- Incomplete Overlap: Studies may analyze different SNPs
- Cohort Overlap: Some cohorts participate in multiple studies (inflates significance)
- Publication Bias: Significant findings more likely to be published
- Winner's Curse: Discovery studies overestimate effect sizes
- Imputation Quality: Varies across studies and populations
Statistical Limitations
- Heterogeneity: High I² may preclude meaningful meta-analysis
- Sample Size Differences: Large studies dominate fixed-effects models
- Allele Frequency Differences: Same variant has different effects across ancestries
- Linkage Disequilibrium: Fine-mapping needed to identify causal variants
- Gene-Environment Interactions: Not captured in standard meta-analysis
Interpretation Guidelines
When I² > 75%:
- Meta-analysis results should be interpreted with extreme caution
- Investigate sources of heterogeneity systematically
- Consider ancestry-specific or subgroup analyses
- Descriptive comparison may be more appropriate than meta-analysis
When Studies Conflict:
- Check for methodological differences
- Verify phenotype definitions match
- Investigate population stratification
- Consider conditional analysis
Tools Used
GWAS Catalog API
gwas_search_studies: Find studies by traitgwas_get_study_by_id: Get detailed study metadatagwas_get_associations_for_study: Retrieve study associationsgwas_get_associations_for_snp: Get SNP associations across studiesgwas_search_associations: Search associations by trait
Open Targets Genetics GraphQL API
OpenTargets_search_gwas_studies_by_disease: Disease-based study searchOpenTargets_get_gwas_study: Detailed study information with LD populationsOpenTargets_get_variant_credible_sets: Fine-mapped loci for variantOpenTargets_get_study_credible_sets: All credible sets for studyOpenTargets_get_variant_info: Variant annotation and allele frequencies
Glossary
Credible Set: Set of variants likely to contain the causal variant (from fine-mapping)
L2G (Locus-to-Gene): Score predicting which gene is affected by a GWAS locus License: Open source (MIT)
Frequently asked questions about GWAS Study Explorer
Similar skills
Scientific Problem Selection
Streamline your research problem selection process.
Nextflow Development
Run nf-core bioinformatics pipelines with ease.
Nature Reviewer Assessment
Simulate peer review for scientific manuscripts.
Research Writing Pipeline
Streamline your scientific writing with structured proposal-first methodologies.
Nature Literature Downloader
Efficiently download academic literature from various sources.
Auto Research
Streamline your NeMo-RL experiments with automated workflows.
