tooluniverse-gwas-trait-to-gene

Discover causal genes for diseases/traits from GWAS data using Open Targets L2G (locus-to-gene) scoring — integrates eQTL, chromatin interaction, and distance evidence. Use for trait-to-gene mapping, drug-target hypothesis generation from GWAS, and replacing the 'nearest gene' heuristic with multi-e

By mims-harvard · 352 installs

npx skills add mims-harvard/tooluniverse --skill tooluniverse-gwas-trait-to-gene

Source repository · Upstream listing

GWAS Trait to Gene Discovery Nearest gene is often wrong. Use L2G (locus to gene) scores from Open Targets which integrate eQTL, chromatin interaction, and distance data. L2G 0.5 is a strong prediction; positional mapping alone should not be used to claim a causal gene. A single GWAS study with p < 5e 8 is suggestive — replication across independent cohorts is required for high confidence. GWAS hits are associations in the studied population; effect sizes and even the implicated gene can differ across ancestries due to differing LD patterns. Treat gene lists from GWAS as ranked candidates for validation, not confirmed causal genes. LOOK UP DON'T GUESS : never assume trait to gene mappings or L2G scores — always call gwas search associations and OpenTargets get study credible sets to retrieve current data; associations are updated as new GWAS are published. Discover genes associated with diseases and traits using genome wide association studies (GWAS) Overview This skill enables systematic discovery of genes linked to diseases/traits by analyzing GWAS data from two major resources: GWAS Catalog (EBI/NHGRI): Curated catalog of published GWAS with 500,000 associations Open Targets Genetics : Fine mapped GWAS signals with locus to gene (L2G) predictions Use Cases Clinical Research "What genes are associated with type 2 diabetes?" "Find genetic risk factors for coronary artery disease" "Which genes contribute to Alzheimer's disease susceptibility?" Drug Target Discovery Identify genes with strong genetic evidence for disease causation Prioritize targets based on L2G scores and replication across studies Find genes with genome wide significant associations (p < 5e 8) Functional Genomics Map disease associated variants to candidate genes Analyze genetic architecture of complex traits Understand polygenic disease mechanisms Workflow Key Concepts Genome wide Significance Standard threshold: p < 5×10⁻⁸ Accounts for multiple testing burden across ~1M common variants Higher confidence: p < 5×10⁻¹⁰ or replicated across studies Gene Mapping Methods Positional : Nearest gene to lead SNP Fine mapping : Statistical refinement to credible variants Locus to Gene (L2G) : Integrative score combining multiple evidence types Evidence Confidence Levels High : L2G score 0.5 OR multiple studies with p < 5e 10 Medium : 2+ studies with p < 5e 8 Low : Single study or marginal significance Required ToolUniverse Tools GWAS Catalog (11 tools) gwas get associations for trait Get all associations for a trait (sorted by p value). NOTE: This tool is BROKEN use gwas search associations(query=trait) as a working alternative gwas search snps Search SNPs by gene mapping gwas get snp by id Get SNP details (MAF, consequence, location) gwas get study by id Get study metadata gwas search associations Search associations with filters (RECOMMENDED for trait lookups) gwas search studies Search studies by trait/cohort gwas get associations for snp Get all associations for a SNP gwas get variants for trait Get variants for a trait. Supports p value threshold parameter for server side filtering (see notes below) gwas get studies for trait Get studies for a trait gwas get snps for gene Get SNPs mapped to a gene. Parameter is gene symbol (NOT mapped gene ) gwas get associations for study Get associations from a study Open Targets Genetics (6 tools) OpenTargets search gwas studies by disease Search studies by disease ontology OpenTargets get study credible sets Get fine mapped loci for a study OpenTargets get variant credible sets Get credible sets for a variant OpenTargets get variant info Get variant annotation (frequencies, consequences) OpenTargets get gwas study Get study metadata OpenTargets get credible set detail Get detailed credible set information Parameters Required trait Disease/trait name (e.g., "type 2 diabetes", "coronary artery disease") Optional p value threshold Significance threshold (default: 5e 8) min evidence count Minimum number of studies (default: 1) max results Maximum genes to return (default: 100) use fine mapping Include L2G predictions (default: true) disease ontology id Disease ontology ID for Open Targets (e.g., "MONDO 0005148") Output Schema Example Results Type 2 Diabetes Alzheimer's Disease Best Practices 1. Use Disease Ontology IDs for Precision 2. Filter by Evidence Strength 3. Interpret Results Carefully Association ≠ Causation : GWAS identifies correlated variants, not necessarily causal genes Linkage Disequilibrium : Lead SNP may tag the true causal variant in a nearby gene Fine mapping : L2G scores provide better causal gene evidence than positional mapping Functional Evidence : Validate with orthogonal data (eQTLs, knockout models, etc.) Tool Specific Notes (Updated) gwas get variants for trait p value Filtering This tool now accepts an optional p value threshold parameter for server side p value filtering. When provided, the GWAS Catalog API filters variants to only return those below the specified threshold. Client side fallback : When the API returns unfiltered results (some trait queries ignore the threshold parameter), the tool also applies client side p value filtering. This means you may see fewer results than expected if the API returned pre filtered data and the client filter applies again. Always check the actual p values in the returned data. gwas get associations for trait BROKEN This tool returns errors for most queries. Use gwas search associations(query=<trait ) as a reliable alternative. The response format is {data: [{...}], metadata: {...}} . gwas get snps for gene Parameter Rename The parameter was renamed from mapped gene to gene symbol for clarity. Use: Programmatic Access (Beyond Tools) When ToolUniverse tools return limited results or you need the full GWAS Catalog: See tooluniverse data wrangling skill for pagination, bulk download, and format parsing patterns. Limitations 1. Gene Mapping Uncertainty Positional mapping assigns SNPs to nearest gene (may be incorrect) Fine mapping available for only a subset of studies Intergenic variants difficult to map 2. Population Bias Most GWAS in European populations Effect sizes may differ across ancestries Rare variants often under represented 3. Sample Size Dependence Larger studies detect more associations Older small studies may have false negatives p values alone don't indicate effect size 4. Validation Bug Some ToolUniverse tools have oneOf validation issues Use validate=False parameter if needed This is automatically handled in the Python implementation Related Skills Variant to Disease Association : Look up specific SNPs (e.g., rs7903146 → T2D) Gene to Disease Links : Find diseases associated with known genes Drug Target Prioritization : Rank targets by genetic evidence Population Genetics Analysis : Compare allele frequencies across populations Data Sources GWAS Catalog Curator: EBI and NHGRI URL: https://www.ebi.ac.uk/gwas/ Coverage: 100,000+ publications, 500,000+ associations Update Frequency: Weekly Open Targets Genetics Curator: Open Targets consortium URL: https://genetics.opentargets.org/ Coverage: Fine mapped GWAS, L2G predictions, QTL colocalization Update Frequency: Quarterly Citation If you use this skill in research, please cite: Support For issues with: Skill functionality : Open issue at tooluniverse/skills GWAS data : Contact GWAS Catalog or Open Targets support Tool errors : Check ToolUniverse tool status