gtex-database
Use when you want to retrieve quantitative RNA expression data and variant eQTL information from the GTEx (Genotype-Tissue Expression) Project across 54 non-diseased tissue sites.
Install / Use
npx skills add google-deepmind/science-skills --skill gtex_databaseInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Data & AnalyticsSupported Platforms
Our assessment of gtex-database
gtex-database scores 93/100 on our quality scale, 115th of 604 Data & Analytics skills we index (top 20%).
Its SKILL.md is 5.9 KB long, well organised into 18 sections with 7 code examples: a thorough specification that gives an agent plenty to work with.
With 3,137 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so gtex-database is actively maintained.
- Our last check on 2026-10-26 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
gtex-database compared with similar skills
All 4 of these similar skills score higher than gtex-database; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| gtex-database (this skill)by google-deepmind | 93 | 3.1k | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
| crawl4aiby unclecode | 100 | 87.4k | 3d ago | MCP Server |
Frequently asked questions
- How do I install gtex-database?
- Run
npx skills add google-deepmind/science-skills --skill gtex-database. The install tabs above show the steps for each supported agent. - Which AI agents does gtex-database work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is gtex-database safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is gtex-database still maintained?
- The repository was last updated about 2 months ago, so gtex-database is actively maintained.
Skill content
View source on GitHubname: gtex-database description: > Use when you want to retrieve quantitative RNA expression data and variant eQTL information from the GTEx (Genotype-Tissue Expression) Project across 54 non-diseased tissue sites.
GTEx Database Integration
This 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.
Prerequisites
uv: Read theuvskill and follow its Setup instructions to ensureuvis installed and on PATH.- User Notification: If .licenses/gtex_database_LICENSE.txt does not already exist in the workspace root directory then (1) prominently notify the user to check the terms at https://gtexportal.org/home/license and https://gtexportal.org/home/documentationPage#gtexApi, then (2) create the file recording the notification text and timestamp.
When to Use
Use this skill when you need to:
- Map a gene symbol to its Versioned GENCODE ID.
- Retrieve the baseline median expression level (in TPM) of a gene across various tissues.
- Find the top tissues where a particular gene is most highly expressed.
- Fetch significant single-tissue eQTLs for a variant or within a chromosomal window.
- Get all significant eQTLs associated with a specific gene.
- Contextualise a variant within GWAS loci using eQTL data.
Do NOT use when you need to:
- Query for protein-level expression or post-translational modifications (PTMs). GTEx only measures mRNA abundance.
- Query gene expression in diseased tissues (e.g., tumor samples, cirrhosis). GTEx is a baseline atlas of normal, non-diseased tissues.
- Query embryonic or fetal gene expression. GTEx donors are adults only.
Core Rules
CRITICAL: You MUST respect GTEx Portal API Terms of Use.
- Use the Wrapper: ALWAYS execute the provided helper scripts to query the database rather than accessing the database directly. The scripts automatically enforce the required rate limit gracefully.
- Limit requests to maximum 250 items per page where applicable.
- Notification: If this skill is used, ensure this is mentioned in the output.
Command Selection Guide
Pick the right command on the first try. Match the user's input to the correct subcommand below.
- Map a gene symbol to GENCODE ID:
resolve-gencode-id - Get median expression (TPM) for a gene:
get-median-expression - Find tissues with highest expression for a gene:
get-top-expressed-tissues - Get all eQTLs for a specific gene:
get-gene-eqtls - Find eQTLs within a chromosomal region:
get-eqtls-in-region
Quick Start
# 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.
Commands
1. resolve-gencode-id — Gene Symbol → GENCODE ID
Maps 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).
2. 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).
3. get-top-expressed-tissues — Get Top Expressed Tissues
Returns 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.
4. get-gene-eqtls — Get All eQTLs for a Gene
Returns 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.
5. get-eqtls-in-region — Get eQTLs in Chromosomal Region
Returns 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.
Typical Workflows
Identify highest expressing tissues for a gene
# 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
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.4kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
