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

$curl -o ~/.claude/skills/region-gene-elements/SKILL.md --create-dirs "https://raw.githubusercontent.com/SpectrAI-Initiative/InnoClaw/main/.claude/skills/region-gene-elements/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/region-gene-elements/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How region-gene-elements Compares

Feature / Agentregion-gene-elementsStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/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

tcga-gene-expression

370
from SpectrAI-Initiative/InnoClaw

Retrieve gene expression data from TCGA (The Cancer Genome Atlas) to analyze cancer-specific expression patterns.

regulatory_region_analysis

370
from SpectrAI-Initiative/InnoClaw

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

370
from SpectrAI-Initiative/InnoClaw

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).

protocol-generation-from-description

370
from SpectrAI-Initiative/InnoClaw

Generate detailed laboratory protocols from natural language descriptions using AI, producing step-by-step experimental procedures ready for lab execution.

population_genetics

370
from SpectrAI-Initiative/InnoClaw

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

370
from SpectrAI-Initiative/InnoClaw

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).

ncbi-gene-retrieval

370
from SpectrAI-Initiative/InnoClaw

Retrieve gene information from NCBI Gene database by gene IDs to obtain genomic details, function, and expression data.

multispecies_gene_analysis

370
from SpectrAI-Initiative/InnoClaw

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).

kegg-gene-search

370
from SpectrAI-Initiative/InnoClaw

Search KEGG database for gene information to retrieve pathway associations, functional annotations, and disease links.

genetic_counseling_report

370
from SpectrAI-Initiative/InnoClaw

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_variant_drug_nexus

370
from SpectrAI-Initiative/InnoClaw

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).

gene_to_drug_pipeline

370
from SpectrAI-Initiative/InnoClaw

Gene-to-Drug Discovery Pipeline - Full gene-to-drug pipeline: gene lookup, protein structure, binding pocket, virtual screening, and drug-likeness. Use this skill for translational medicine tasks involving get gene metadata by gene name pred protein structure esmfold run fpocket boltz binding affinity calculate mol drug chemistry. Combines 5 tools from 3 SCP server(s).