region-gene-elements
Query IGVF Catalog for regulatory element–gene associations within a genomic region, including association scores, element types, and biosample context.
Best use case
region-gene-elements is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Query IGVF Catalog for regulatory element–gene associations within a genomic region, including association scores, element types, and biosample context.
Teams using region-gene-elements should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/region-gene-elements/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How region-gene-elements Compares
| Feature / Agent | region-gene-elements | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Query IGVF Catalog for regulatory element–gene associations within a genomic region, including association scores, element types, and biosample context.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# IGVF Catalog — Regulatory Element–Gene Associations by Region
## Usage
### Tool Description
```tex
Query IGVF Catalog API to find regulatory-element-to-gene associations within a genomic region.
Database: IGVF Catalog (https://api.catalogkg.igvf.org/)
API: GET https://api.catalogkg.igvf.org/api/genomic-elements/genes
Args:
region (str): Required. Genomic region, e.g. "chr1:903900-904900"
organism (str): Default "Homo sapiens"
source_annotation (str, optional): e.g. "enhancer", "intergenic"
region_type (str, optional): e.g. "accessible dna elements", "tested elements"
source (str, optional): e.g. "ENCODE_EpiRaction"
method (str, optional): e.g. "CRISPR FACS screen"
biosample_name (str, optional): e.g. "placenta"
verbose (bool): true=返回完整信息, false=精简 (default false)
page (int): 0-based page
limit (int): 每页条目数, 最大 500
Return (list of dicts), each item contains:
- score (float): 调控元件与基因的关联分数
- source (str): 数据来源 (e.g. "ENCODE")
- source_url (str): 来源链接
- genomic_element (dict):
- chr, start, end: 调控元件基因组坐标
- source_annotation: 元件注释类型 (intergenic, enhancer, promoter 等)
- type: 元件类型 (accessible dna elements, tested elements 等)
- gene (dict):
- _id: Ensembl Gene ID (e.g. "ENSG00000187634")
- name: 基因名 (e.g. "SAMD11")
- chr, start, end, strand: 基因坐标
- gene_type: 基因类型 (protein_coding, lncRNA 等)
- hgnc: HGNC ID (e.g. "HGNC:28706")
- entrez: Entrez ID (e.g. "ENTREZ:148398")
- biosample (str): 来源生物样本 (e.g. "natural killer cell...")
- method (str): 实验方法 (e.g. "CRISPR FACS screen")
```
### Query Example
```python
import requests
region = "chr1:903900-904900"
url = "https://api.catalogkg.igvf.org/api/genomic-elements/genes"
params = {
"region": region,
"organism": "Homo sapiens",
"verbose": "true",
"page": 0,
}
resp = requests.get(url, params=params, timeout=30).json()
print(f"[IGVF] 区域 {region} 内调控元件-基因关联: {len(resp)} 条")
for i, item in enumerate(resp[:10]):
gene = item.get("gene", {})
elem = item.get("genomic_element", {})
print(f"\n [{i+1}] 基因: {gene.get('name', 'N/A')} ({gene.get('_id', '')})")
print(f" 基因坐标: {gene.get('chr')}:{gene.get('start')}-{gene.get('end')} ({gene.get('strand')})")
print(f" 基因类型: {gene.get('gene_type', '')}")
print(f" 调控元件: {elem.get('chr')}:{elem.get('start')}-{elem.get('end')}")
print(f" 元件类型: {elem.get('type', '')} ({elem.get('source_annotation', '')})")
print(f" 关联分数: {item.get('score', 'N/A')}")
print(f" 来源: {item.get('source', '')}, 方法: {item.get('method', '')}")
print(f" 样本: {item.get('biosample', '')[:60]}")
```Related Skills
regulatory_region_analysis
Regulatory Region Analysis - Analyze regulatory regions: get overlapping features, binding matrix, sequence, and phenotype associations. Use this skill for epigenomics tasks involving get overlap region get species binding matrix get sequence get phenotype region. Combines 4 tools from 2 SCP server(s).
rare_disease_genetics
Rare Disease Genetic Analysis - Analyze rare disease genetics: Monarch phenotype-disease mapping, ClinVar variants, NCBI gene data, and OpenTargets. Use this skill for rare disease genetics tasks involving get HPO ID by phenotype get joint associated diseases by HPO ID list clinvar search get associated targets by disease efoId. Combines 4 tools from 3 SCP server(s).
population_genetics
Population Genetics Analysis - Analyze population genetics: Ensembl variation populations, linkage disequilibrium, and variant frequency data. Use this skill for population genetics tasks involving get info variation populations get ld get variation get variant recoder. Combines 4 tools from 1 SCP server(s).
ncbi_gene_deep_dive
NCBI Gene Deep Dive - Deep dive into NCBI gene: metadata, dataset report, product report, orthologs, and gene links. Use this skill for gene biology tasks involving get gene metadata by gene name get gene dataset report by id get gene product report by id get gene orthologs get gene links by id. Combines 5 tools from 1 SCP server(s).
multispecies_gene_analysis
Multi-Species Gene Analysis - Analyze gene across species: Ensembl homologs, NCBI orthologs, cross-species STRING similarity, and taxonomy. Use this skill for comparative genomics tasks involving get homology symbol get gene orthologs get best similarity hits between species get taxonomy. Combines 4 tools from 3 SCP server(s).
genetic_counseling_report
Genetic Counseling Variant Report - Generate variant report for genetic counseling: VEP, ClinVar, gene phenotype, and literature evidence. Use this skill for clinical genetics tasks involving get vep hgvs clinvar search get phenotype gene pubmed search. Combines 4 tools from 2 SCP server(s).
gene_therapy_target
Gene Therapy Target Analysis - Analyze gene therapy target: gene info, variant pathogenicity, protein structure, and clinical evidence. Use this skill for gene therapy tasks involving get gene metadata by gene name get vep hgvs Protein structure prediction ESMFold clinvar search. Combines 4 tools from 4 SCP server(s).
gene_family_evolution
Gene Family Evolution Analysis - Analyze gene family evolution: CAFE gene tree, homology, Ensembl gene tree, and taxonomy. Use this skill for molecular evolution tasks involving get cafe genetree member symbol get homology symbol get genetree member symbol get taxonomy classification. Combines 4 tools from 1 SCP server(s).
gene_expression_atlas
Gene Expression Atlas - Build gene expression atlas: TCGA cancer expression, NCBI gene info, Ensembl gene details, and literature search. Use this skill for transcriptomics tasks involving get gene expression across cancers get gene metadata by gene name get lookup symbol search literature. Combines 4 tools from 4 SCP server(s).
gene_disease_association
Gene-Disease Association Analysis - Analyze gene-disease associations: NCBI gene metadata, OpenTargets disease associations, TCGA expression, and Monarch phenotypes. Use this skill for medical genetics tasks involving get gene metadata by gene name get associated targets by disease efoId get gene expression across cancers get joint associated diseases by HPO ID list. Combines 4 tools from 4 SCP server(s).
gene_comprehensive_lookup
Gene Comprehensive Lookup - Comprehensive gene lookup: NCBI gene data, Ensembl gene info, UniProt protein data, and KEGG pathway links. Use this skill for bioinformatics tasks involving get gene metadata by gene name get lookup symbol get general info by protein or gene name kegg find. Combines 4 tools from 4 SCP server(s).
gene_variant_drug_nexus
Gene-Variant-Drug Nexus - Connect gene variants to drugs: variant effect, gene-disease link, drug associations, and clinical evidence. Use this skill for translational genomics tasks involving get vep hgvs get associated targets by disease efoId get associated drugs by target name clinvar search. Combines 4 tools from 3 SCP server(s).