Agent skill

Tf Target Gene Regulatory Network

by aipoch in aipoch/medical-research-skills

A skill your agent uses when analyzing transcription factor (TF) regulatory networks using Dorothea database.

MITAuto-check passedMedia & Creative

Install Tf Target Gene Regulatory Network

skills CLI
$ npx skills add aipoch/medical-research-skills --skill tf-target-gene-regulatory-network -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aipoch/medical-research-skills tf-target-gene-regulatory-network --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aipoch/medical-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/'awesome-med-research-skills/Data Analysis/tf-target-gene-regulatory-network' .claude/skills/tf-target-gene-regulatory-network && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tf-target-gene-regulatory-network
GitHub stars
1.9k
Token cost
~2.6k tokens
SKILL.md length
985 words
Files
61 (incl. scripts, references)
Skills in repo
578
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when analyzing transcription factor (TF) regulatory networks using Dorothea database.

  • Works in 4 steps: Load Database → Identify Regulating TFs → Generate Network Data → …
  • Analyzing transcription factor (TF) regulatory networks using Dorothea database
  • SKILL.md covers When to Use, When Not to Use, Input Validation and Entry Point, plus 9 more sections
  • Runs R scripts from its folder

What it does

Tf Target Gene Regulatory Network is an agent skill from aipoch/medical-research-skills. Use when analyzing transcription factor (TF) regulatory networks using Dorothea database. Input gene list, identify regulating transcription factors, generate TF-Target network visualization. For: transcription factor enrichment analysis, gene regulatory network research.

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 65 other files, including scripts and reference files (for example `eval_report_tf-target-gene-regulatory-network_result.json`, `references/algorithm.md` and `references/cli-guide.md`).

It sits in Media & Creative, covering Transcription. The repository describes itself as: Hundreds of agent skills for medical research, including protocol design, data analysis, evidence insights, and academic writing. The licence is MIT.

When your agent uses it

  • Analyzing transcription factor (TF) regulatory networks using Dorothea database
  • Tasks that involve Transcription

Example prompts

  • “/tf-target-gene-regulatory-network”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Load Database
  2. Identify Regulating TFs
  3. Generate Network Data
  4. Visualize Network

What it can do on your machine

Read from SKILL.md and the folder at commit 686e09d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 5 files in scripts/ (R, from the files we listed), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tf Target Gene Regulatory Network loads about 2.6k tokens when it runs, and up to ~8k if it reads all its reference files. Until then it costs about 77 tokens; SKILL.md has 985 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~77
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from aipoch/medical-research-skills at commit 686e09d, republished under its MIT licence (© aipoch). 985 words, ~2,594 tokens.

Download SKILL.mdSave it as .claude/skills/tf-target-gene-regulatory-network/SKILL.md (or your agent's skills folder). This skill also uses 60 other files; get the full folder from GitHub.
name
tf-target-gene-regulatory-network
description
Use when analyzing transcription factor (TF) regulatory networks using Dorothea database. Input gene list, identify regulating transcription factors, generate TF-Target network visualization. For: transcription factor enrichment analysis, gene regulatory network research.
license
MIT
skill-author
AIPOCH

Transcription Factor (TF) Regulatory Network Analysis

When to Use

  • Use this skill when you have a human or mouse gene list and want to identify upstream TFs from the Dorothea database.
  • Use it when you need a ready-to-export TF-target network table plus a publication-ready PDF network plot.
  • Use it for reproducible CLI execution with saved session information and optional local Dorothea .rds databases.

When Not to Use

  • Do not use this skill for differential expression, pathway enrichment, cell type annotation, or survival analysis.
  • Do not use it to infer causal direction beyond curated Dorothea TF-target relationships.
  • Do not use it when your input genes are aliases or mixed-species symbols that have not been normalized first.

Input Validation

This skill accepts: a human or mouse gene list (HGNC symbols for human, first-letter-uppercase for mouse) for TF regulatory network analysis using Dorothea.

If the user's request does not involve identifying upstream transcription factors from a gene list — for example, asking to run differential expression, pathway enrichment, cell type annotation, or multi-omics integration — do not proceed with the workflow. Instead respond:

"tf-target-gene-regulatory-network is designed to identify upstream transcription factors from a gene list using the Dorothea database and generate a TF-target network visualization. Your request appears to be outside this scope. Please provide a gene list for TF regulatory analysis, or use a more appropriate tool for your task."

Entry Point

  • Primary CLI entry point: scripts/main.R
  • Canonical visualization values: English tokens fr, curve, diamond, triangle, square

When to Read External Files

SituationFile to ReadPurpose
Need algorithm detailsreferences/algorithm.mdStatistical methods, Dorothea database, network analysis algorithms
Need to run analysisscripts/main.RExecute: Rscript scripts/main.R --gene ... --species ...
Encounter errorsreferences/troubleshooting.mdCommon errors and solutions
Need CLI examplesreferences/cli-guide.mdDetailed CLI usage examples
Need test datatests/data/Sample gene lists for testing

Installation

R Package Dependencies
r
# CRAN packages
install.packages(c("optparse", "dplyr", "openxlsx", "tidyverse", "tidygraph", "ggraph", "showtext"))

# Bioconductor packages (optional if using local database files)
if (!require("BiocManager", quietly = TRUE))
    install.packages("BiocManager")
BiocManager::install("dorothea")

For faster analysis and offline use, generate local database files:

bash
Rscript database/database-get.R

This creates database/dorothea_hs.rds (human) and database/dorothea_mm.rds (mouse) in the skill root directory.

Verification
bash
Rscript scripts/main.R --help

Usage

bash
Rscript scripts/main.R \
  --gene "TP53,MYC,EGFR" \
  --species human \
  --output_dir ./TF_Result \
  --seed 42

Arguments

Note: Either --gene or --gene_file must be provided (at least one is required).

ShortLongTypeDefaultDescription
-g--genecharacterNULLComma-separated gene list (e.g., "TP53,MYC,EGFR") — required if --gene_file not provided
-f--gene_filecharacterNULLFile with gene names (txt or csv, one per line or comma-separated) — required if --gene not provided
-s--speciescharacterhumanSpecies: human or mouse
-o--output_dircharacterTF_ResultOutput directory name
--db_pathcharacterNULLLocal .rds database file path. If not specified, auto-searches default paths
-d--dircharacterNULLWorking root directory (advanced)
--seedinteger42Random seed for reproducibility
--titlecharacter""Main plot title

Visualization Parameters: For complete list (plot dimensions, colors, labels, layout, edge styles), see references/visualization-parameters.md. Canonical values are English tokens: fr (force-directed layout), curve (curved edges), diamond / triangle / square (node shapes).


Input Format

Gene List Input

Two ways to provide input genes:

  1. Command line: --gene "TP53,MYC,EGFR" (comma-separated)
  2. File input: --gene_file genes.txt (one gene per line or comma-separated)
Gene Naming Convention
  • Human genes: All uppercase symbols (e.g., TP53, MYC, EGFR)
  • Mouse genes: First letter uppercase only (e.g., Tp53, Myc, Egfr)
  • Use official gene symbols, not aliases
  • Case-sensitive for species matching
Species Support
  • human: Human genes (Homo sapiens)
  • mouse: Mouse genes (Mus musculus)
Performance Guidance

For large gene lists (> 500 genes), Dorothea database queries may take several minutes. Use a local .rds database (--db_path) for substantially faster lookups. There is currently no --timeout_seconds parameter; monitor progress with verbose logging if available.


Show full SKILL.md (412 more words)Show less

Output Files

FileDescription
TF_Network_Plot.pdfTF-target network visualization
tf_network.xlsxNetwork data (edges and nodes worksheets)
TF_Target_Filtered_Core_<species>.xlsxComplete TF-target relationships table
session_info.txtR session and package version info
tf.RdataR environment data

Outputs are organized under TF_Result/ in data/, plot/, and table/ subdirectories.


Workflow

Step 1: Load Database
  • Priority search for local database files (.rds format) in: --db_path, getwd()/database/, script_dir/database/, dirname(script_dir)/database/
  • If no local file found, load from Dorothea R package
  • Filter for high-confidence interactions (confidence levels A, B, C)
Step 2: Identify Regulating TFs
  • Match input genes against target genes in Dorothea database
  • Extract transcription factors regulating these targets
  • Compute TF frequency (number of targets regulated)
Step 3: Generate Network Data
  • Create edge list (TF → Target relationships)
  • Create node list with types (TF or Target)
  • Save to Excel format for downstream analysis
Step 4: Visualize Network
  • Generate network graph using tidygraph and ggraph
  • Apply visual customization (layout, colors, shapes)
  • Save as PDF publication-ready figure

Methods

Dorothea Database
Network Analysis
  • Graph construction: TF-target relationships as directed edges
  • Layout algorithms: Multiple options including fr (force-directed), circle, grid, sphere
  • Visual customization: Full control over colors, shapes, sizes
Local Database Feature
  • Option to use pre-saved .rds files for faster analysis and offline use
  • Priority search paths for local database files (see Step 1 above)
  • Fallback to Dorothea R package if no local file found

Examples

Basic Usage (Human Genes)
bash
Rscript scripts/main.R \
  -g "TP53,MYC,EGFR" \
  -s human \
  -o ./TF_Result
File Input
bash
Rscript scripts/main.R \
  -f gene_list.txt \
  -s human \
  -o ./TF_Result
Mouse Genes
bash
Rscript scripts/main.R \
  -g "Tp53,Myc,Egfr" \
  -s mouse \
  -o ./Mouse_TF_Result
Custom Styling
bash
Rscript scripts/main.R \
  -g "PTPRC,FOXP3,CD4" \
  -s human \
  --style_layout "fr" \
  --style_line "curve" \
  --point_shape "diamond,triangle" \
  --line_color "#E64B35" \
  --title "Immune TF Network" \
  -o ./Custom_Plot
Using Local Database
bash
Rscript scripts/main.R \
  -g "TP53,MYC,EGFR" \
  -s human \
  --db_path database/dorothea_hs.rds \
  -o ./LocalDB_Result

Error Handling

Common Errors
Error CodeCauseSolution
SKILL_FILE_NOT_FOUNDInput gene file does not existCheck file path and permissions
SKILL_NO_INPUT_GENESEmpty gene list or fileProvide genes using --gene or --gene_file
SKILL_INVALID_SPECIESSpecies not human or mouseUse human or mouse only
SKILL_INVALID_PARAMETERInvalid layout, shape, line, or legend valueUse supported values shown by Rscript scripts/main.R --help
SKILL_EMPTY_RESULTSNo TF-target relationships found for input genesCheck gene symbols and species; try broadening confidence levels
SKILL_DEPENDENCY_MISSINGMissing dplyr, dorothea, tidygraph, etc.Install missing packages (see Installation section)
Exit Status Codes
CodeMeaning
0Success
1Execution error (see error code for details)
2SKILL_EMPTY_RESULTS — no TF-target matches found for the input genes

IF error persists, READ: references/troubleshooting.md


Testing

Test with Sample Data
bash
# Check help
Rscript scripts/main.R --help

# Run with sample human genes
Rscript scripts/main.R \
  -g "TP53,MYC,EGFR" \
  -s human \
  -o tests/output_human/

# Run with sample mouse genes
Rscript scripts/main.R \
  -g "Tp53,Myc,Egfr" \
  -s mouse \
  -o tests/output_mouse/

After running, verify tests/output_human/plot/TF_Network_Plot.pdf and tests/output_human/table/tf_network.xlsx exist and are non-empty.

Reference Files

FilePurpose
references/algorithm.mdStatistical methods and Dorothea database details
references/troubleshooting.mdCommon errors and solutions
references/cli-guide.mdCLI usage examples
references/visualization-parameters.mdComplete visualization parameter list

© aipoch, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 60 other files (scripts, references) in awesome-med-research-skills/Data Analysis/tf-target-gene-regulatory-network of aipoch/medical-research-skills.

  • SKILL.md
  • DESCRIPTION
  • database/database-get.R
  • database/dorothea_hs.rds
  • database/dorothea_mm.rds
  • eval_report_tf-target-gene-regulatory-network_result.json
  • references/algorithm.md
  • references/cli-guide.md
  • references/troubleshooting.md
  • references/visualization-parameters.md
  • scripts/functions.R
  • scripts/main.R
  • scripts/run_analysis.R
  • scripts/utils.R
  • scripts/visualization.R
  • tests/audit_v2_case_aliases/data
  • … and 45 more

Open the folder on GitHubat commit 686e09d

Compare with similar skills

Tf Target Gene Regulatory Network next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tf Target Gene Regulatory Network compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tf Target Gene Regulatory Network this skillaipoch/medical-research-skills1.9k—~2.6kAutomated safety check: PassMIT
HyperFrames Media Useheygen-com/hyperframes60k—~2.4kAutomated safety check: PassApache-2.0
Native Subtitle Quote Imagechengyi-ai/native-subtitle-quote-image2.6k—~2.4kAutomated safety check: PassMIT
Edu Chem Videowy51ai/edulab1.4k—~2.1kAutomated safety check: NotesApache-2.0
Transcription Memory ReconstructionNxcoreAI/EverRoom3k—~714Automated safety check: PassCustom licence
Edu Math Videowy51ai/edulab1.4k—~2.5kAutomated safety check: NotesApache-2.0

Similar skills

  • HyperFrames Media Use

    heygen-com/hyperframes

    Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.

    60k GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Native Subtitle Quote Image

    chengyi-ai/native-subtitle-quote-image

    将本地视频或用户有权处理的在线视频,经过来源获取、文字稿定位、选题选句、精确取帧、紧凑裁切、拼图和逐张质检,制作成 3:4 或保留画面原比例的视频字幕长图。支持两种明确分开的输出:保留画面内已烧录字幕的原生字幕模式,以及把已审核的时间点与台词绘制到真实视频帧上的脚本字幕模式。用户要求原生字幕截图、字幕帧拼图、YouTube…

    2.6k GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Edu Chem Video

    wy51ai/edulab

    A skill your agent uses when asked to make an explainer / walkthrough video (讲解视频、解题视频、例题精讲、微课) for a chemistry problem (化学题: 氧化还原配平 双线桥 电子守恒, 物质的量计算, 化学平衡 三段式 平衡常数 转化率 反应速率, 离子反应, 电化学, 溶液 滴定…

    1.4k GitHub stars~2.1k tokensUpdated yesterday
    Media & CreativeAuto-check: notes
  • Reconstruct a complete, searchable memory from an untrusted meeting or conversation transcript.

    3k GitHub stars~714 tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Edu Math Video

    wy51ai/edulab

    A skill your agent uses when asked to make an explainer / walkthrough video (讲解视频、解题视频、例题精讲、微课) for a math problem (数学题, geometry, algebra, functions, motion/行程 problems), from a problem screenshot…

    1.4k GitHub stars~2.5k tokensUpdated yesterday
    Media & CreativeAuto-check: notes
  • Transcribe

    JetBrains/skills

    Official

    Transcribe audio files to text with optional diarization and known-speaker hints.

    366 GitHub starsUsed in 4 repos~776 tokens
    Media & CreativeAuto-check passed

More from aipoch/medical-research-skills

All 578 skills in this repo
  • Academic Poster Generator

    aipoch/medical-research-skills

    Complete workflow for generating academic research posters from PDF literature; use when you need to extract paper content from PDFs and produce a LaTeX-based poster…

    1.9k GitHub stars~2.2k tokensUpdated 24 days ago
    Auto-check passed
  • Diagnostic Study Quality Assessment Quadas

    aipoch/medical-research-skills

    Analyzes clinical diagnostic accuracy studies for bias using the QUADAS-2 tool.

    1.9k GitHub stars~1.4k tokensUpdated 24 days ago
    Auto-check passed
  • Exploratory Data Analysis

    aipoch/medical-research-skills

    Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats.

    1.9k GitHub stars~3.7k tokensUpdated 24 days ago
    Auto-check passed
  • Iso Certification

    aipoch/medical-research-skills

    A toolkit for preparing ISO 13485:2016 certification documentation for medical device QMS.

    1.9k GitHub stars~1.8k tokensUpdated 24 days ago
    Auto-check passed
  • Journal Skills

    aipoch/medical-research-skills

    Recommends target journals for manuscript submission by analyzing the paper topic/abstract and the journal distribution of similar PubMed literature; use when users ask for journal…

    1.9k GitHub stars~1.7k tokensUpdated 24 days ago
    Auto-check passed
  • Latex Posters

    aipoch/medical-research-skills

    Creates academic-poster writing packages for LaTeX using beamerposter, tikzposter, or baposter.

    1.9k GitHub stars~1.3k tokensUpdated 24 days ago
    Auto-check passed

Questions about Tf Target Gene Regulatory Network

What does Tf Target Gene Regulatory Network do?

A skill your agent uses when analyzing transcription factor (TF) regulatory networks using Dorothea database. Tf Target Gene Regulatory Network is an agent skill from aipoch/medical-research-skills. Use when analyzing transcription factor (TF) regulatory networks using Dorothea database.

When should I use Tf Target Gene Regulatory Network?

Tf Target Gene Regulatory Network fits situations like: analyzing transcription factor (TF) regulatory networks using Dorothea database; tasks that involve Transcription.

How do I install Tf Target Gene Regulatory Network in Claude Code?

Run `npx skills add aipoch/medical-research-skills --skill tf-target-gene-regulatory-network -a claude-code`. Or copy the skill folder (awesome-med-research-skills/Data Analysis/tf-target-gene-regulatory-network in aipoch/medical-research-skills) into .claude/skills/tf-target-gene-regulatory-network in your project. Claude Code loads it when a task matches its description.

How do I install Tf Target Gene Regulatory Network in Codex?

Run `npx skills add aipoch/medical-research-skills --skill tf-target-gene-regulatory-network -a codex`. Or copy the skill folder (awesome-med-research-skills/Data Analysis/tf-target-gene-regulatory-network in aipoch/medical-research-skills) into .agents/skills/tf-target-gene-regulatory-network in your project. Codex loads it when a task matches its description.

Can I use Tf Target Gene Regulatory Network in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aipoch/medical-research-skills --skill tf-target-gene-regulatory-network -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tf-target-gene-regulatory-network, .gemini/skills/tf-target-gene-regulatory-network, .github/skills/tf-target-gene-regulatory-network and .opencode/skills/tf-target-gene-regulatory-network in your project.

What does Tf Target Gene Regulatory Network need to run?

Going by SKILL.md and its folder, Tf Target Gene Regulatory Network needs R for the scripts in its folder.

Does Tf Target Gene Regulatory Network access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Tf Target Gene Regulatory Network safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Tf Target Gene Regulatory Network use?

Tf Target Gene Regulatory Network is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tf Target Gene Regulatory Network use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.4k tokens, read only when the agent opens those files.

What are the alternatives to Tf Target Gene Regulatory Network?

Skills that share tags, products or a category with Tf Target Gene Regulatory Network: HyperFrames Media Use (heygen-com/hyperframes, 60k stars), Native Subtitle Quote Image (chengyi-ai/native-subtitle-quote-image, 2.6k stars), Edu Chem Video (wy51ai/edulab, 1.4k stars) and Transcription Memory Reconstruction (NxcoreAI/EverRoom, 3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tf Target Gene Regulatory Network?

aipoch (a GitHub organization) maintains it in aipoch/medical-research-skills, which has 1,937 GitHub stars. The repository holds 578 skills in this directory. The repository was last updated on September 17, 2026.

Source: aipoch/medical-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.