Terminal
Terminal/Skill
Retrieves RNA expression levels and expression quantitative trait loci (eQTL) data from the GTEx Project across 54 non-diseased tissues, for genomics research.
By Google
Works with
npx skills add google-deepmind/science-skills --skill gtex-databaseThis skill retrieves transcriptomics data (RNA expression baselines) and expression Quantitative Trait Loci (eQTLs) from the GTEx Portal API V2. It provides access to median TPM (Transcripts Per Million) values for genes and significant eQTLs for variants across 54 human tissue sites.
uv: Read the uv skill and follow its Setup instructions to ensure
uv is installed and on PATH.Use this skill when you need to:
Do NOT use when you need to:
CRITICAL: You MUST respect GTEx Portal API Terms of Use.
Pick the right command on the first try. Match the user's input to the correct subcommand below.
resolve-gencode-idget-median-expressionget-top-expressed-tissuesget-gene-eqtlsget-eqtls-in-region# Map the TNF gene symbol to its GENCODE ID
uv run scripts/gtex_cli.py resolve-gencode-id TNF --output /tmp/tnf_id.json
# Get median expression of a gene by GENCODE ID
uv run scripts/gtex_cli.py get-median-expression ENSG00000232810.2 --output /tmp/tnf_expr.json
All subcommands write JSON to disk. Always save output in the /tmp/ directory.
The default output file is /tmp/gtex_output.json if --output is not
specified.
resolve-gencode-id — Gene Symbol → GENCODE IDMaps a standard gene symbol (e.g., "JUN", "TNF") to its Versioned GENCODE ID. This ID is required for all other expression and eQTL calls.
uv run scripts/gtex_cli.py resolve-gencode-id TNF --output /tmp/tnf_id.json
Arguments:
gene_symbol (positional): The standard gene symbol (e.g., "TNF").--output: Output file path (default: /tmp/gtex_output.json).get-median-expression — Get Median Expression (TPM)Retrieves the median TPM for a gene across all 54 GTEx tissue sites or specified tissues.
uv run scripts/gtex_cli.py get-median-expression ENSG00000232810.2 \
--tissues "Whole Blood,Spleen" --output /tmp/expr.json
Arguments:
gencode_id (positional): The Versioned GENCODE ID.--tissues: Comma-separated list of tissue IDs (optional, defaults to all
54 tissues).--output: Output file path (default: /tmp/gtex_output.json).get-top-expressed-tissues — Get Top Expressed TissuesReturns the n tissues with the highest median expression for the target gene.
uv run scripts/gtex_cli.py get-top-expressed-tissues ENSG00000232810.2 \
--n 5 --output /tmp/top_tissues.json
Arguments:
gencode_id (positional): The Versioned GENCODE ID.--n: Number of top tissues to return (default: 5).--output: Output file path.get-gene-eqtls — Get All eQTLs for a GeneReturns every significant eQTL associated with the gene across specified tissues.
uv run scripts/gtex_cli.py get-gene-eqtls ENSG00000232810.2 \
--tissues "Whole Blood" --output /tmp/eqtls.json
Arguments:
gencode_id (positional): The Versioned GENCODE ID.--tissues: Comma-separated list of tissue IDs (optional, defaults to all).--output: Output file path.get-eqtls-in-region — Get eQTLs in Chromosomal RegionReturns all significant single-tissue eQTLs within a chromosomal window (up to 8Mb).
uv run scripts/gtex_cli.py get-eqtls-in-region chr17 7000000 7100000 "Esophagus - Muscularis" \
--output /tmp/region_eqtls.json
Arguments:
chromosome (positional): Chromosome name (e.g., chr17).start (positional): Start position.end (positional): End position (max 8Mb from start).tissue_id (positional): The target tissue ID.--output: Output file path.# Step 1: Map symbol to GENCODE ID
uv run scripts/gtex_cli.py resolve-gencode-id GATA4 --output /tmp/gata4_id.json
# Step 2: Query for top tissues using the resolved ID
uv run scripts/gtex_cli.py get-top-expressed-tissues <gencode_id> --n 5 \
--output /tmp/gata4_top.json