tooluniverse-gwas-trait-to-gene — скилл для Claude Code: установка
Скилл tooluniverse-gwas-trait-to-gene для Claude Code сопоставляет заболевания и признаки с кандидатными генами по GWAS и L2G-оценкам Open Targets. Ищет гены и гипотезы лекарственных мишеней.
Apache-2.0 369 установок ★ 1 798 обновлён 2026-10-24
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-gwas-trait-to-gene -a claude-codeЧто делает tooluniverse-gwas-trait-to-gene
Скилл ищет GWAS-ассоциации по признаку, собирает значимые SNP, связывает их с генами и ранжирует кандидатов по p-value, числу исследований и данным fine-mapping. Для L2G он обращается к gwas_search_associations и OpenTargets_get_study_credible_sets, объединяя данные GWAS Catalog и Open Targets Genetics.
В результате для каждого гена можно получить символ, минимальное p-value, число независимых исследований, SNP, исследования, L2G score и уровень уверенности. Значение L2G выше 0.5 считается сильным предсказанием, но список генов остаётся набором кандидатов для проверки, а не доказанными причинными генами.
Укажите trait; при необходимости задайте p_value_threshold, min_evidence_count, max_results, use_fine_mapping или disease_ontology_id. Поскольку gwas_get_associations_for_trait сломан, для поиска признака используется gwas_search_associations. Один GWAS с p < 5e-8 требует репликации, а различия в LD между популяциями могут изменить связанные гены.
Какие задачи решает
- найти гены, связанные с заболеванием или признаком
- собрать значимые SNP из GWAS
- сопоставить локусы с кандидатными генами
- отранжировать гены по L2G и числу исследований
- подготовить гипотезы лекарственных мишеней
Примеры запросов агенту
- Используй скилл для поиска генов, связанных с признаком «type 2 diabetes», и верни L2G-оценки.
- Найди GWAS-ассоциации для «coronary artery disease», оставь результаты с p < 5e-8 и покажи число независимых исследований.
- Сопоставь локусы для «Alzheimer's disease» с кандидатными генами через Open Targets и укажи уровень уверенности.
Как установить tooluniverse-gwas-trait-to-gene
1Через Skills CLI (Vercel)
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-gwas-trait-to-gene -a claude-code2Вручную: положить файлы
~/.claude/skills/tooluniverse-gwas-trait-to-gene/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tooluniverse-gwas-trait-to-gene/
1Через Skills CLI (Vercel)
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-gwas-trait-to-gene -a codex2Вручную: положить файлы
.agents/skills/tooluniverse-gwas-trait-to-gene/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-gwas-trait-to-gene -a cursor2Вручную: положить файлы
.cursor/skills/tooluniverse-gwas-trait-to-gene/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mims-harvard/ToolUniverse skills/tooluniverse-gwas-trait-to-gene2Вручную: положить файлы
.github/skills/tooluniverse-gwas-trait-to-gene/SKILL.md1Через Skills CLI (Vercel)
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-gwas-trait-to-gene -a gemini-cli2Командой платформы
gemini skills install https://github.com/mims-harvard/ToolUniverse --path skills/tooluniverse-gwas-trait-to-geneВручную: положить файлы
.devin/skills/tooluniverse-gwas-trait-to-gene/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-gwas-trait-to-gene -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о tooluniverse-gwas-trait-to-gene
Как установить tooluniverse-gwas-trait-to-gene в Claude Code?
Выполните npx skills add mims-harvard/ToolUniverse --skill tooluniverse-gwas-trait-to-gene -a claude-code, затем проверьте файл ~/.claude/skills/tooluniverse-gwas-trait-to-gene/SKILL.md.
Что делает tooluniverse-gwas-trait-to-gene?
Скилл ищет связи между GWAS-признаками и генами, добавляет L2G-предсказания Open Targets и возвращает ранжированный список кандидатов с показателями значимости и подтверждения.
Можно ли считать найденный ген причинным?
Нет. L2G выше 0.5 — сильное предсказание, но ген остаётся кандидатом для проверки; результаты одного исследования нужно реплицировать.
Исходный текст
SKILL.md · Apache-2.0
---
name: tooluniverse-gwas-trait-to-gene
description: 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-evidence L2G scores.
disable-model-invocation: true
---
# 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
```
1. Trait Search → Search GWAS Catalog by disease/trait name
↓
2. SNP Aggregation → Collect genome-wide significant SNPs (p < 5e-8)
↓
3. Gene Mapping → Extract mapped genes from associations
↓
4. Evidence Ranking → Score by p-value, replication, fine-mapping
↓
5. Annotation (Optional) → Add L2G predictions from Open Targets
```
## 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. **No p-value threshold parameter** (one passed in is silently ignored) -- filter client-side on `pvalue_mantissa`/`pvalue_exponent` (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
```python
{
"genes": [
{
"symbol": str, # Gene symbol (e.g., "TCF7L2")
"min_p_value": float, # Most significant p-value
"evidence_count": int, # Number of independent studies
"snps": [str], # Associated SNP rs IDs
"studies": [str], # GWAS study accessions
"l2g_score": float | null, # Locus-to-gene score (0-1)
"credible_sets": int, # Number of credible sets
"confidence_level": str # "High", "Medium", or "Low"
}
],
"summary": {
"trait": str,
"total_associations": int,
"significant_genes": int,
"data_sources": ["GWAS Catalog", "Open Targets"]
}
}
```
## Example Results
**Type 2 Diabetes**
```
TCF7L2: p=1.2e-98, 15 studies, L2G=0.82 → High confidence
KCNJ11: p=3.4e-67, 12 studies, L2G=0.76 → High confidence
PPARG: p=2.1e-45, 8 studies, L2G=0.71 → High confidence
FTO: p=5.6e-42, 10 studies, L2G=0.68 → High confidence
IRS1: p=8.9e-38, 6 studies, L2G=0.54 → High confidence
```
**Alzheimer's Disease**
```
APOE: p=1.0e-450, 25 studies, L2G=0.95 → High confidence
BIN1: p=2.3e-89, 18 studies, L2G=0.88 → High confidence
CLU: p=4.5e-67, 16 studies, L2G=0.82 → High confidence
ABCA7: p=6.7e-54, 14 studies, L2G=0.79 → High confidence
CR1: p=8.9e-52, 13 studies, L2G=0.75 → High confidence
```
## Best Practices
**1. Use Disease Ontology IDs for Precision**
```
# Instead of:
discover_gwas_genes("diabetes") # Ambiguous
# Use:
discover_gwas_genes(
"type 2 diabetes",
disease_ontology_id="MONDO_0005148" # Specific
)
```
**2. Filter by Evidence Strength**
```
# For drug targets, require strong evidence:
discover_gwas_genes(
"coronary artery disease",
p_value_threshold=5e-10, # Stricter than GWAS threshold
min_evidence_count=3, # Multiple independent studies
use_fine_mapping=True # Include L2G predictions
)
```
**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 has **no p-value threshold parameter**. A `p_value_threshold=...` argument is
silently ignored (verified live: output identical with and without it), so filter the
returned associations yourself. Use `sort="p_value", direction="asc"` to get the strongest
associations first, and `page`/`size` to page (`metadata.pagination.totalElements` is the total).
```python
result = tu.tools.gwas_get_variants_for_trait(
trait="type 2 diabetes", size=200, sort="p_value", direction="asc"
)
def genome_wide_significant(a, exp=-8, mant=5): # p < 5e-8
return (a['pvalue_exponent'], a['pvalue_mantissa']) < (exp, mant)
hits = [a for a in result['data'] if genome_wide_significant(a)]
```
Filter on `pvalue_mantissa` and `pvalue_exponent`, not `p_value`: the `p_value` float underflows
to `0.0` for very small p-values (e.g. 3 x 10^-1315), so it cannot be compared to a threshold.
### `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:
```python
result = tu.tools.gwas_get_snps_for_gene(gene_symbol="TCF7L2")
```
---
## Programmatic Access (Beyond Tools)
When ToolUniverse tools return limited results or you need the full GWAS Catalog:
```python
import requests, pandas as pd
# Download full GWAS Catalog (all associations, ~37MB TSV)
url = "https://www.ebi.ac.uk/gwas/api/search/downloads/alternative"
df = pd.read_csv(url, sep="\t")
# Filter locally by trait or gene
hits = df[df["DISEASE/TRAIT"].str.contains("type 2 diabetes", case=False, na=False)]
gene_hits = df[df["MAPPED_GENE"].str.contains("TCF7L2", na=False)]
# Per-study associations via REST
study_id = "GCST001234"
assocs = requests.get(f"https://www.ebi.ac.uk/gwas/rest/api/studies/{study_id}/associations").json()
# Summary statistics (when available)
# Check study page for fullPvalueSet=true, then download from linked FTP
```
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:
```
Buniello A, et al. (2019) The NHGRI-EBI GWAS Catalog of published genome-wide
association studies. Nucleic Acids Research, 47(D1):D1005-D1012.
Mountjoy E, et al. (2021) An open approach to systematically prioritize causal
variants and genes at all published human GWAS trait-associated loci.
Nature Genetics, 53:1527-1533.
```
## 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
© mims-harvard · Apache-2.0 · mims-harvard/ToolUniverse