[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6DNZGR81FVNA2AG5G6NGGJV":3,"skill-same:01M6DNZGR81FVNA2AG5G6NGGJV":63},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":31,"linkOnly":32,"markdownContent":33,"markdownBody":34,"frontMatter":35,"refName":38,"commitSha":39,"skillDirectory":5,"forksCount":14,"repositoryHtmlUrl":40,"repositoryHomepageUrl":6,"ownerHtmlUrl":41,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":42,"install":43,"resources":56},"01M6DNZGR81FVNA2AG5G6NGGJV","gtex-database",null,"Query GTEx (Genotype-Tissue Expression) portal for tissue-specific gene expression, eQTLs (expression quantitative trait loci), and sQTLs. Essential for linking GWAS variants to gene regulation, understanding tissue-specific expression, and interpreting non-coding variant effects.","huamu668\u002Fclawhub-openclaw-medical","huamu668","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F202473531?v=4","01M6DK1V7D7VP9PJ06Z1VXVK13","huamu","01M6DK1VBYG1BX5FT154AFZHAS",0,"CC-BY-4.0","https:\u002F\u002Fgithub.com\u002Fhuamu668\u002Fclawhub-openclaw-medical\u002Fblob\u002Fmain\u002Fgtex-database\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",[24,25,26,27,28,29,30],"database","gtex database","coding","query","gene expression","essential","expression","2026-11-10 10:12:30",false,"---\nname: gtex-database\ndescription: Query GTEx (Genotype-Tissue Expression) portal for tissue-specific gene expression, eQTLs (expression quantitative trait loci), and sQTLs. Essential for linking GWAS variants to gene regulation, understanding tissue-specific expression, and interpreting non-coding variant effects.\nlicense: CC-BY-4.0\nmetadata:\n    skill-author: Kuan-lin Huang\n---\n\n# GTEx Database\n\n## Overview\n\nThe Genotype-Tissue Expression (GTEx) project provides a comprehensive resource for studying tissue-specific gene expression and genetic regulation across 54 non-diseased human tissues from nearly 1,000 individuals. GTEx v10 (the latest release) enables researchers to understand how genetic variants regulate gene expression (eQTLs) and splicing (sQTLs) in a tissue-specific manner, which is critical for interpreting GWAS loci and identifying regulatory mechanisms.\n\n**Key resources:**\n- GTEx Portal: https:\u002F\u002Fgtexportal.org\u002F\n- GTEx API v2: https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002F\n- Data downloads: https:\u002F\u002Fgtexportal.org\u002Fhome\u002Fdownloads\u002Fadult-gtex\u002F\n- Documentation: https:\u002F\u002Fgtexportal.org\u002Fhome\u002FdocumentationPage\n\n## When to Use This Skill\n\nUse GTEx when:\n\n- **GWAS locus interpretation**: Identifying which gene a non-coding GWAS variant regulates via eQTLs\n- **Tissue-specific expression**: Comparing gene expression levels across 54 human tissues\n- **eQTL colocalization**: Testing if a GWAS signal and an eQTL signal share the same causal variant\n- **Multi-tissue eQTL analysis**: Finding variants that regulate expression in multiple tissues\n- **Splicing QTLs (sQTLs)**: Identifying variants that affect splicing ratios\n- **Tissue specificity analysis**: Determining which tissues express a gene of interest\n- **Gene expression exploration**: Retrieving normalized expression levels (TPM) per tissue\n\n## Core Capabilities\n\n### 1. GTEx REST API v2\n\nBase URL: `https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002F`\n\nThe API returns JSON and does not require authentication. All endpoints support pagination.\n\n```python\nimport requests\n\nBASE_URL = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\"\n\ndef gtex_get(endpoint, params=None):\n    \"\"\"Make a GET request to the GTEx API.\"\"\"\n    url = f\"{BASE_URL}\u002F{endpoint}\"\n    response = requests.get(url, params=params, headers={\"Accept\": \"application\u002Fjson\"})\n    response.raise_for_status()\n    return response.json()\n```\n\n### 2. Gene Expression by Tissue\n\n```python\nimport requests\nimport pandas as pd\n\ndef get_gene_expression_by_tissue(gene_id_or_symbol, dataset_id=\"gtex_v10\"):\n    \"\"\"Get median gene expression across all tissues.\"\"\"\n    url = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002Fexpression\u002FmedianGeneExpression\"\n    params = {\n        \"gencodeId\": gene_id_or_symbol,\n        \"datasetId\": dataset_id,\n        \"itemsPerPage\": 100\n    }\n    response = requests.get(url, params=params)\n    data = response.json()\n\n    records = data.get(\"data\", [])\n    df = pd.DataFrame(records)\n    if not df.empty:\n        df = df[[\"tissueSiteDetailId\", \"tissueSiteDetail\", \"median\", \"unit\"]].sort_values(\n            \"median\", ascending=False\n        )\n    return df\n\n# Example: get expression of APOE across tissues\ndf = get_gene_expression_by_tissue(\"ENSG00000130203.10\")  # APOE GENCODE ID\n# Or use gene symbol (some endpoints accept both)\nprint(df.head(10))\n# Output: tissue name, median TPM, sorted by highest expression\n```\n\n### 3. eQTL Lookup\n\n```python\nimport requests\nimport pandas as pd\n\ndef query_eqtl(gene_id, tissue_id=None, dataset_id=\"gtex_v10\"):\n    \"\"\"Query significant eQTLs for a gene, optionally filtered by tissue.\"\"\"\n    url = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002Fassociation\u002FsingleTissueEqtl\"\n    params = {\n        \"gencodeId\": gene_id,\n        \"datasetId\": dataset_id,\n        \"itemsPerPage\": 250\n    }\n    if tissue_id:\n        params[\"tissueSiteDetailId\"] = tissue_id\n\n    all_results = []\n    page = 0\n    while True:\n        params[\"page\"] = page\n        response = requests.get(url, params=params)\n        data = response.json()\n        results = data.get(\"data\", [])\n        if not results:\n            break\n        all_results.extend(results)\n        if len(results) \u003C params[\"itemsPerPage\"]:\n            break\n        page += 1\n\n    df = pd.DataFrame(all_results)\n    if not df.empty:\n        df = df.sort_values(\"pval\", ascending=True)\n    return df\n\n# Example: Find eQTLs for PCSK9\ndf = query_eqtl(\"ENSG00000169174.14\")\nprint(df[[\"snpId\", \"tissueSiteDetailId\", \"slope\", \"pval\", \"gencodeId\"]].head(20))\n```\n\n### 4. Single-Tissue eQTL by Variant\n\n```python\nimport requests\n\ndef query_variant_eqtl(variant_id, tissue_id=None, dataset_id=\"gtex_v10\"):\n    \"\"\"Get all eQTL associations for a specific variant.\"\"\"\n    url = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002Fassociation\u002FsingleTissueEqtl\"\n    params = {\n        \"variantId\": variant_id,  # e.g., \"chr1_55516888_G_GA_b38\"\n        \"datasetId\": dataset_id,\n        \"itemsPerPage\": 250\n    }\n    if tissue_id:\n        params[\"tissueSiteDetailId\"] = tissue_id\n\n    response = requests.get(url, params=params)\n    return response.json()\n\n# GTEx variant ID format: chr{chrom}_{pos}_{ref}_{alt}_b38\n# Example: \"chr17_43094692_G_A_b38\"\n```\n\n### 5. Multi-Tissue eQTL (eGenes)\n\n```python\nimport requests\n\ndef get_egenes(tissue_id, dataset_id=\"gtex_v10\"):\n    \"\"\"Get all eGenes (genes with at least one significant eQTL) in a tissue.\"\"\"\n    url = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002Fassociation\u002Fegene\"\n    params = {\n        \"tissueSiteDetailId\": tissue_id,\n        \"datasetId\": dataset_id,\n        \"itemsPerPage\": 500\n    }\n\n    all_egenes = []\n    page = 0\n    while True:\n        params[\"page\"] = page\n        response = requests.get(url, params=params)\n        data = response.json()\n        batch = data.get(\"data\", [])\n        if not batch:\n            break\n        all_egenes.extend(batch)\n        if len(batch) \u003C params[\"itemsPerPage\"]:\n            break\n        page += 1\n    return all_egenes\n\n# Example: all eGenes in whole blood\negenes = get_egenes(\"Whole_Blood\")\nprint(f\"Found {len(egenes)} eGenes in Whole Blood\")\n```\n\n### 6. Tissue List\n\n```python\nimport requests\n\ndef get_tissues(dataset_id=\"gtex_v10\"):\n    \"\"\"Get all available tissues with metadata.\"\"\"\n    url = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002Fdataset\u002FtissueSiteDetail\"\n    params = {\"datasetId\": dataset_id, \"itemsPerPage\": 100}\n    response = requests.get(url, params=params)\n    return response.json()[\"data\"]\n\ntissues = get_tissues()\n# Key fields: tissueSiteDetailId, tissueSiteDetail, colorHex, samplingSite\n# Common tissue IDs:\n# Whole_Blood, Brain_Cortex, Liver, Kidney_Cortex, Heart_Left_Ventricle,\n# Lung, Muscle_Skeletal, Adipose_Subcutaneous, Colon_Transverse, ...\n```\n\n### 7. sQTL (Splicing QTLs)\n\n```python\nimport requests\n\ndef query_sqtl(gene_id, tissue_id=None, dataset_id=\"gtex_v10\"):\n    \"\"\"Query significant sQTLs for a gene.\"\"\"\n    url = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002Fassociation\u002FsingleTissueSqtl\"\n    params = {\n        \"gencodeId\": gene_id,\n        \"datasetId\": dataset_id,\n        \"itemsPerPage\": 250\n    }\n    if tissue_id:\n        params[\"tissueSiteDetailId\"] = tissue_id\n\n    response = requests.get(url, params=params)\n    return response.json()\n```\n\n## Query Workflows\n\n### Workflow 1: Interpreting a GWAS Variant via eQTLs\n\n1. **Identify the GWAS variant** (rs ID or chromosome position)\n2. **Convert to GTEx variant ID format** (`chr{chrom}_{pos}_{ref}_{alt}_b38`)\n3. **Query all eQTL associations** for that variant across tissues\n4. **Check effect direction**: is the GWAS risk allele the same as the eQTL effect allele?\n5. **Prioritize tissues**: select tissues biologically relevant to the disease\n6. **Consider colocalization** using `coloc` (R package) with full summary statistics\n\n```python\nimport requests, pandas as pd\n\ndef interpret_gwas_variant(variant_id, dataset_id=\"gtex_v10\"):\n    \"\"\"Find all genes regulated by a GWAS variant.\"\"\"\n    url = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002Fassociation\u002FsingleTissueEqtl\"\n    params = {\"variantId\": variant_id, \"datasetId\": dataset_id, \"itemsPerPage\": 500}\n    response = requests.get(url, params=params)\n    data = response.json()\n\n    df = pd.DataFrame(data.get(\"data\", []))\n    if df.empty:\n        return df\n    return df[[\"geneSymbol\", \"tissueSiteDetailId\", \"slope\", \"pval\", \"maf\"]].sort_values(\"pval\")\n\n# Example\nresults = interpret_gwas_variant(\"chr1_154453788_A_T_b38\")\nprint(results.groupby(\"geneSymbol\")[\"tissueSiteDetailId\"].count().sort_values(ascending=False))\n```\n\n### Workflow 2: Gene Expression Atlas\n\n1. Get median expression for a gene across all tissues\n2. Identify the primary expression site(s)\n3. Compare with disease-relevant tissues\n4. Download raw data for statistical comparisons\n\n### Workflow 3: Tissue-Specific eQTL Analysis\n\n1. Select tissues relevant to your disease\n2. Query all eGenes in that tissue\n3. Cross-reference with GWAS-significant loci\n4. Identify co-localized signals\n\n## Key API Endpoints\n\n| Endpoint | Description |\n|----------|-------------|\n| `\u002Fexpression\u002FmedianGeneExpression` | Median TPM by tissue for a gene |\n| `\u002Fexpression\u002FgeneExpression` | Full distribution of expression per tissue |\n| `\u002Fassociation\u002FsingleTissueEqtl` | Significant eQTL associations |\n| `\u002Fassociation\u002FsingleTissueSqtl` | Significant sQTL associations |\n| `\u002Fassociation\u002Fegene` | eGenes in a tissue |\n| `\u002Fdataset\u002FtissueSiteDetail` | Available tissues with metadata |\n| `\u002Freference\u002Fgene` | Gene metadata (GENCODE IDs, coordinates) |\n| `\u002Fvariant\u002FvariantPage` | Variant lookup by rsID or position |\n\n## Datasets Available\n\n| ID | Description |\n|----|-------------|\n| `gtex_v10` | GTEx v10 (current; ~960 donors, 54 tissues) |\n| `gtex_v8` | GTEx v8 (838 donors, 49 tissues) — older but widely cited |\n\n## Best Practices\n\n- **Use GENCODE IDs** (e.g., `ENSG00000130203.10`) for gene queries; the `.version` suffix matters for some endpoints\n- **GTEx variant IDs** use the format `chr{chrom}_{pos}_{ref}_{alt}_b38` (GRCh38) — different from rs IDs\n- **Handle pagination**: Large queries (e.g., all eGenes) require iterating through pages\n- **Tissue nomenclature**: Use `tissueSiteDetailId` (e.g., `Whole_Blood`) not display names for API calls\n- **FDR correction**: GTEx uses FDR \u003C 0.05 (q-value) as the significance threshold for eQTLs\n- **Effect alleles**: The `slope` field is the effect of the alternative allele; positive = higher expression with alt allele\n\n## Data Downloads (for large-scale analysis)\n\nFor genome-wide analyses, download full summary statistics rather than using the API:\n\n```bash\n# All significant eQTLs (v10)\nwget https:\u002F\u002Fstorage.googleapis.com\u002Fadult-gtex\u002Fbulk-qtl\u002Fv10\u002Fsingle-tissue-cis-qtl\u002FGTEx_Analysis_v10_eQTL.tar\n\n# Normalized expression matrices\nwget https:\u002F\u002Fstorage.googleapis.com\u002Fadult-gtex\u002Fbulk-gex\u002Fv10\u002Frna-seq\u002FGTEx_Analysis_v10_RNASeQCv2.4.2_gene_reads.gct.gz\n```\n\n## Additional Resources\n\n- **GTEx Portal**: https:\u002F\u002Fgtexportal.org\u002F\n- **API documentation**: https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002F\n- **Data downloads**: https:\u002F\u002Fgtexportal.org\u002Fhome\u002Fdownloads\u002Fadult-gtex\u002F\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fbroadinstitute\u002Fgtex-pipeline\n- **Citation**: GTEx Consortium (2020) Science. PMID: 32913098\n","# GTEx Database\n\n## Overview\n\nThe Genotype-Tissue Expression (GTEx) project provides a comprehensive resource for studying tissue-specific gene expression and genetic regulation across 54 non-diseased human tissues from nearly 1,000 individuals. GTEx v10 (the latest release) enables researchers to understand how genetic variants regulate gene expression (eQTLs) and splicing (sQTLs) in a tissue-specific manner, which is critical for interpreting GWAS loci and identifying regulatory mechanisms.\n\n**Key resources:**\n- GTEx Portal: https:\u002F\u002Fgtexportal.org\u002F\n- GTEx API v2: https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002F\n- Data downloads: https:\u002F\u002Fgtexportal.org\u002Fhome\u002Fdownloads\u002Fadult-gtex\u002F\n- Documentation: https:\u002F\u002Fgtexportal.org\u002Fhome\u002FdocumentationPage\n\n## When to Use This Skill\n\nUse GTEx when:\n\n- **GWAS locus interpretation**: Identifying which gene a non-coding GWAS variant regulates via eQTLs\n- **Tissue-specific expression**: Comparing gene expression levels across 54 human tissues\n- **eQTL colocalization**: Testing if a GWAS signal and an eQTL signal share the same causal variant\n- **Multi-tissue eQTL analysis**: Finding variants that regulate expression in multiple tissues\n- **Splicing QTLs (sQTLs)**: Identifying variants that affect splicing ratios\n- **Tissue specificity analysis**: Determining which tissues express a gene of interest\n- **Gene expression exploration**: Retrieving normalized expression levels (TPM) per tissue\n\n## Core Capabilities\n\n### 1. GTEx REST API v2\n\nBase URL: `https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002F`\n\nThe API returns JSON and does not require authentication. All endpoints support pagination.\n\n```python\nimport requests\n\nBASE_URL = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\"\n\ndef gtex_get(endpoint, params=None):\n    \"\"\"Make a GET request to the GTEx API.\"\"\"\n    url = f\"{BASE_URL}\u002F{endpoint}\"\n    response = requests.get(url, params=params, headers={\"Accept\": \"application\u002Fjson\"})\n    response.raise_for_status()\n    return response.json()\n```\n\n### 2. Gene Expression by Tissue\n\n```python\nimport requests\nimport pandas as pd\n\ndef get_gene_expression_by_tissue(gene_id_or_symbol, dataset_id=\"gtex_v10\"):\n    \"\"\"Get median gene expression across all tissues.\"\"\"\n    url = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002Fexpression\u002FmedianGeneExpression\"\n    params = {\n        \"gencodeId\": gene_id_or_symbol,\n        \"datasetId\": dataset_id,\n        \"itemsPerPage\": 100\n    }\n    response = requests.get(url, params=params)\n    data = response.json()\n\n    records = data.get(\"data\", [])\n    df = pd.DataFrame(records)\n    if not df.empty:\n        df = df[[\"tissueSiteDetailId\", \"tissueSiteDetail\", \"median\", \"unit\"]].sort_values(\n            \"median\", ascending=False\n        )\n    return df\n\n# Example: get expression of APOE across tissues\ndf = get_gene_expression_by_tissue(\"ENSG00000130203.10\")  # APOE GENCODE ID\n# Or use gene symbol (some endpoints accept both)\nprint(df.head(10))\n# Output: tissue name, median TPM, sorted by highest expression\n```\n\n### 3. eQTL Lookup\n\n```python\nimport requests\nimport pandas as pd\n\ndef query_eqtl(gene_id, tissue_id=None, dataset_id=\"gtex_v10\"):\n    \"\"\"Query significant eQTLs for a gene, optionally filtered by tissue.\"\"\"\n    url = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002Fassociation\u002FsingleTissueEqtl\"\n    params = {\n        \"gencodeId\": gene_id,\n        \"datasetId\": dataset_id,\n        \"itemsPerPage\": 250\n    }\n    if tissue_id:\n        params[\"tissueSiteDetailId\"] = tissue_id\n\n    all_results = []\n    page = 0\n    while True:\n        params[\"page\"] = page\n        response = requests.get(url, params=params)\n        data = response.json()\n        results = data.get(\"data\", [])\n        if not results:\n            break\n        all_results.extend(results)\n        if len(results) \u003C params[\"itemsPerPage\"]:\n            break\n        page += 1\n\n    df = pd.DataFrame(all_results)\n    if not df.empty:\n        df = df.sort_values(\"pval\", ascending=True)\n    return df\n\n# Example: Find eQTLs for PCSK9\ndf = query_eqtl(\"ENSG00000169174.14\")\nprint(df[[\"snpId\", \"tissueSiteDetailId\", \"slope\", \"pval\", \"gencodeId\"]].head(20))\n```\n\n### 4. Single-Tissue eQTL by Variant\n\n```python\nimport requests\n\ndef query_variant_eqtl(variant_id, tissue_id=None, dataset_id=\"gtex_v10\"):\n    \"\"\"Get all eQTL associations for a specific variant.\"\"\"\n    url = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002Fassociation\u002FsingleTissueEqtl\"\n    params = {\n        \"variantId\": variant_id,  # e.g., \"chr1_55516888_G_GA_b38\"\n        \"datasetId\": dataset_id,\n        \"itemsPerPage\": 250\n    }\n    if tissue_id:\n        params[\"tissueSiteDetailId\"] = tissue_id\n\n    response = requests.get(url, params=params)\n    return response.json()\n\n# GTEx variant ID format: chr{chrom}_{pos}_{ref}_{alt}_b38\n# Example: \"chr17_43094692_G_A_b38\"\n```\n\n### 5. Multi-Tissue eQTL (eGenes)\n\n```python\nimport requests\n\ndef get_egenes(tissue_id, dataset_id=\"gtex_v10\"):\n    \"\"\"Get all eGenes (genes with at least one significant eQTL) in a tissue.\"\"\"\n    url = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002Fassociation\u002Fegene\"\n    params = {\n        \"tissueSiteDetailId\": tissue_id,\n        \"datasetId\": dataset_id,\n        \"itemsPerPage\": 500\n    }\n\n    all_egenes = []\n    page = 0\n    while True:\n        params[\"page\"] = page\n        response = requests.get(url, params=params)\n        data = response.json()\n        batch = data.get(\"data\", [])\n        if not batch:\n            break\n        all_egenes.extend(batch)\n        if len(batch) \u003C params[\"itemsPerPage\"]:\n            break\n        page += 1\n    return all_egenes\n\n# Example: all eGenes in whole blood\negenes = get_egenes(\"Whole_Blood\")\nprint(f\"Found {len(egenes)} eGenes in Whole Blood\")\n```\n\n### 6. Tissue List\n\n```python\nimport requests\n\ndef get_tissues(dataset_id=\"gtex_v10\"):\n    \"\"\"Get all available tissues with metadata.\"\"\"\n    url = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002Fdataset\u002FtissueSiteDetail\"\n    params = {\"datasetId\": dataset_id, \"itemsPerPage\": 100}\n    response = requests.get(url, params=params)\n    return response.json()[\"data\"]\n\ntissues = get_tissues()\n# Key fields: tissueSiteDetailId, tissueSiteDetail, colorHex, samplingSite\n# Common tissue IDs:\n# Whole_Blood, Brain_Cortex, Liver, Kidney_Cortex, Heart_Left_Ventricle,\n# Lung, Muscle_Skeletal, Adipose_Subcutaneous, Colon_Transverse, ...\n```\n\n### 7. sQTL (Splicing QTLs)\n\n```python\nimport requests\n\ndef query_sqtl(gene_id, tissue_id=None, dataset_id=\"gtex_v10\"):\n    \"\"\"Query significant sQTLs for a gene.\"\"\"\n    url = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002Fassociation\u002FsingleTissueSqtl\"\n    params = {\n        \"gencodeId\": gene_id,\n        \"datasetId\": dataset_id,\n        \"itemsPerPage\": 250\n    }\n    if tissue_id:\n        params[\"tissueSiteDetailId\"] = tissue_id\n\n    response = requests.get(url, params=params)\n    return response.json()\n```\n\n## Query Workflows\n\n### Workflow 1: Interpreting a GWAS Variant via eQTLs\n\n1. **Identify the GWAS variant** (rs ID or chromosome position)\n2. **Convert to GTEx variant ID format** (`chr{chrom}_{pos}_{ref}_{alt}_b38`)\n3. **Query all eQTL associations** for that variant across tissues\n4. **Check effect direction**: is the GWAS risk allele the same as the eQTL effect allele?\n5. **Prioritize tissues**: select tissues biologically relevant to the disease\n6. **Consider colocalization** using `coloc` (R package) with full summary statistics\n\n```python\nimport requests, pandas as pd\n\ndef interpret_gwas_variant(variant_id, dataset_id=\"gtex_v10\"):\n    \"\"\"Find all genes regulated by a GWAS variant.\"\"\"\n    url = \"https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002Fassociation\u002FsingleTissueEqtl\"\n    params = {\"variantId\": variant_id, \"datasetId\": dataset_id, \"itemsPerPage\": 500}\n    response = requests.get(url, params=params)\n    data = response.json()\n\n    df = pd.DataFrame(data.get(\"data\", []))\n    if df.empty:\n        return df\n    return df[[\"geneSymbol\", \"tissueSiteDetailId\", \"slope\", \"pval\", \"maf\"]].sort_values(\"pval\")\n\n# Example\nresults = interpret_gwas_variant(\"chr1_154453788_A_T_b38\")\nprint(results.groupby(\"geneSymbol\")[\"tissueSiteDetailId\"].count().sort_values(ascending=False))\n```\n\n### Workflow 2: Gene Expression Atlas\n\n1. Get median expression for a gene across all tissues\n2. Identify the primary expression site(s)\n3. Compare with disease-relevant tissues\n4. Download raw data for statistical comparisons\n\n### Workflow 3: Tissue-Specific eQTL Analysis\n\n1. Select tissues relevant to your disease\n2. Query all eGenes in that tissue\n3. Cross-reference with GWAS-significant loci\n4. Identify co-localized signals\n\n## Key API Endpoints\n\n| Endpoint | Description |\n|----------|-------------|\n| `\u002Fexpression\u002FmedianGeneExpression` | Median TPM by tissue for a gene |\n| `\u002Fexpression\u002FgeneExpression` | Full distribution of expression per tissue |\n| `\u002Fassociation\u002FsingleTissueEqtl` | Significant eQTL associations |\n| `\u002Fassociation\u002FsingleTissueSqtl` | Significant sQTL associations |\n| `\u002Fassociation\u002Fegene` | eGenes in a tissue |\n| `\u002Fdataset\u002FtissueSiteDetail` | Available tissues with metadata |\n| `\u002Freference\u002Fgene` | Gene metadata (GENCODE IDs, coordinates) |\n| `\u002Fvariant\u002FvariantPage` | Variant lookup by rsID or position |\n\n## Datasets Available\n\n| ID | Description |\n|----|-------------|\n| `gtex_v10` | GTEx v10 (current; ~960 donors, 54 tissues) |\n| `gtex_v8` | GTEx v8 (838 donors, 49 tissues) — older but widely cited |\n\n## Best Practices\n\n- **Use GENCODE IDs** (e.g., `ENSG00000130203.10`) for gene queries; the `.version` suffix matters for some endpoints\n- **GTEx variant IDs** use the format `chr{chrom}_{pos}_{ref}_{alt}_b38` (GRCh38) — different from rs IDs\n- **Handle pagination**: Large queries (e.g., all eGenes) require iterating through pages\n- **Tissue nomenclature**: Use `tissueSiteDetailId` (e.g., `Whole_Blood`) not display names for API calls\n- **FDR correction**: GTEx uses FDR \u003C 0.05 (q-value) as the significance threshold for eQTLs\n- **Effect alleles**: The `slope` field is the effect of the alternative allele; positive = higher expression with alt allele\n\n## Data Downloads (for large-scale analysis)\n\nFor genome-wide analyses, download full summary statistics rather than using the API:\n\n```bash\n# All significant eQTLs (v10)\nwget https:\u002F\u002Fstorage.googleapis.com\u002Fadult-gtex\u002Fbulk-qtl\u002Fv10\u002Fsingle-tissue-cis-qtl\u002FGTEx_Analysis_v10_eQTL.tar\n\n# Normalized expression matrices\nwget https:\u002F\u002Fstorage.googleapis.com\u002Fadult-gtex\u002Fbulk-gex\u002Fv10\u002Frna-seq\u002FGTEx_Analysis_v10_RNASeQCv2.4.2_gene_reads.gct.gz\n```\n\n## Additional Resources\n\n- **GTEx Portal**: https:\u002F\u002Fgtexportal.org\u002F\n- **API documentation**: https:\u002F\u002Fgtexportal.org\u002Fapi\u002Fv2\u002F\n- **Data downloads**: https:\u002F\u002Fgtexportal.org\u002Fhome\u002Fdownloads\u002Fadult-gtex\u002F\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fbroadinstitute\u002Fgtex-pipeline\n- **Citation**: GTEx Consortium (2020) Science. PMID: 32913098\n",{"name":5,"license":15,"metadata":36,"description":7},{"skill-author":37},"Kuan-lin Huang","main","d3998984163a67a891ee8397e35adf79b14e872d","https:\u002F\u002Fgithub.com\u002Fhuamu668\u002Fclawhub-openclaw-medical","https:\u002F\u002Fgithub.com\u002Fhuamu668","2026-03-12 11:49:42",{"source":8,"skillName":5,"commands":44,"prompt":54,"zipAvailable":55},[45,48,51],{"tool":46,"command":47},"npx","npx skills add huamu668\u002Fclawhub-openclaw-medical --skill gtex-database",{"tool":49,"command":50},"bunx","bunx skills add huamu668\u002Fclawhub-openclaw-medical --skill gtex-database",{"tool":52,"command":53},"pnpm","pnpm dlx skills add huamu668\u002Fclawhub-openclaw-medical --skill gtex-database","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhuamu668\u002Fclawhub-openclaw-medical\u002Fblob\u002Fmain\u002Fgtex-database\u002FSKILL.md",true,[57],{"path":58,"resourceType":59,"resourceTypeDesc":60,"sizeBytes":61,"sourceHtmlUrl":62},"index.json","REFERENCE","参考文档",633,"https:\u002F\u002Fgithub.com\u002FDCx7C5\u002Fai-marketplace\u002Fblob\u002Fmain\u002Fskills\u002Fidentity-ad-zerologon\u002Findex.json",[64,85,114,134,148,176],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":68,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":31},"01M6DR3JGAEX5G5FR7TK3D8NS8","zarr-python","Chunked N-D arrays for cloud storage. Compressed arrays, parallel I\u002FO, S3\u002FGCS integration, NumPy\u002FDask\u002FXarray compatible, for large-scale scientific computing pipelines.","MIT","https:\u002F\u002Fgithub.com\u002Fhuamu668\u002Fclawhub-openclaw-medical\u002Fblob\u002Fmain\u002Fzarr-python\u002FSKILL.md",[],[72,73,74,75,76,77,78,79,80,81,82,83,84],"python","zarr python","storage","scientific computing","numpy","arrays","pipelines","parallel","dask","cloud","gcs","s3","integration",{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":68,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":94,"publishedAt":31},"01M6DR101MEDE5XT2ZZ5VBEAA5","vaex","Use this skill for processing and analyzing large tabular datasets (billions of rows) that exceed available RAM. Vaex excels at out-of-core DataFrame operations, lazy evaluation, fast aggregations, efficient visualization of big data, and machine learning on large datasets. Apply when users need to work with large CSV\u002FHDF5\u002FArrow\u002FParquet files, perform fast statistics on massive datasets, create visualizations of big data, or build ML pipelines that do not fit in memory.","https:\u002F\u002Fgithub.com\u002Fhuamu668\u002Fclawhub-openclaw-medical\u002Fblob\u002Fmain\u002Fvaex\u002FSKILL.md",[91],{"categoryNo":92,"categoryName":93,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000013","分析与可视化",[87,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113],"machine learning","in memory","learning","csv","visualization","create","core","ml","big data","memory","visualizations","fit","statistics","do","build","files","use","operations","work",{"skillNo":115,"name":116,"nameZh":6,"description":117,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":68,"licenseFileUrl":6,"sourceHtmlUrl":118,"categories":119,"keywords":120,"publishedAt":31},"01M6DQVMB0GBKF2W44FKXVD1P7","torch-geometric","Graph Neural Networks (PyG). Node\u002Fgraph classification, link prediction, GCN, GAT, GraphSAGE, heterogeneous graphs, molecular property prediction, for geometric deep learning.","https:\u002F\u002Fgithub.com\u002Fhuamu668\u002Fclawhub-openclaw-medical\u002Fblob\u002Fmain\u002Ftorch-geometric\u002FSKILL.md",[],[121,97,122,123,124,125,126,127,128,129,130,131,132,133],"torch geometric","node","Neural","link","gat","molecular","graphs","deep","networks","graph","neural networks","deep learning","classification",{"skillNo":135,"name":136,"nameZh":6,"description":137,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":68,"licenseFileUrl":6,"sourceHtmlUrl":138,"categories":139,"keywords":140,"publishedAt":31},"01M6DQH2GZPZKEQ140GRCJ9746","tiledbvcf","Efficient storage and retrieval of genomic variant data using TileDB. Scalable VCF\u002FBCF ingestion, incremental sample addition, compressed storage, parallel queries, and export capabilities for population genomics.","https:\u002F\u002Fgithub.com\u002Fhuamu668\u002Fclawhub-openclaw-medical\u002Fblob\u002Fmain\u002Ftiledbvcf\u002FSKILL.md",[],[136,141,142,143,144,145,146,79,147,74],"data","genomics","sample","queries","ingestion","export","capabilities",{"skillNo":149,"name":150,"nameZh":6,"description":151,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":68,"licenseFileUrl":6,"sourceHtmlUrl":152,"categories":153,"keywords":162,"publishedAt":31},"01M6DQD9G958EM6NHJ994D0SK1","solublempnn","Solubility-optimized protein sequence design using SolubleMPNN. Use this skill when: (1) Designing for E. coli expression, (2) Optimizing solubility of designed proteins, (3) Reducing aggregation propensity, (4) Need high-yield expression, (5) Avoiding inclusion body formation.\nFor standard design, use proteinmpnn. For ligand-aware design, use ligandmpnn.","https:\u002F\u002Fgithub.com\u002Fhuamu668\u002Fclawhub-openclaw-medical\u002Fblob\u002Fmain\u002Fsolublempnn\u002FSKILL.md",[154,157],{"categoryNo":155,"categoryName":156,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":158,"categoryName":159,"taxonomyType":160,"taxonomyTypeDesc":161},"01JBSEEDCAT000000000000032","设计师","PROFESSION","适用职业",[150,163,164,111,165,166,167,168,169,170,171,172,173,174,30,175],"inclusion","yield","modal","Tools","aggregation","design","proteins","solubility","proteinmpnn","ligandmpnn","ligand-aware","inverse-folding","sequence-design",{"skillNo":177,"name":178,"nameZh":6,"description":179,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":180,"licenseFileUrl":6,"sourceHtmlUrl":181,"categories":182,"keywords":183,"publishedAt":31},"01M6DQ8W91A93MGGCEEW949HBC","scvelo","RNA velocity analysis with scVelo. Estimate cell state transitions from unspliced\u002Fspliced mRNA dynamics, infer trajectory directions, compute latent time, and identify driver genes in single-cell RNA-seq data. Complements Scanpy\u002FscVI-tools for trajectory inference.","BSD-3-Clause","https:\u002F\u002Fgithub.com\u002Fhuamu668\u002Fclawhub-openclaw-medical\u002Fblob\u002Fmain\u002Fscvelo\u002FSKILL.md",[],[178,184,185,186,187,188,189,190,191,192,193,166,141,194,195],"RNA","single-cell","infer","cell","transitions","time","compute","velocity","scanpy","analysis","state","inference"]