biomate-ai/biomate-bioconductor-kb/chipseeker

Claude Code and agent skill by biomate-ai/biomate-bioconductor-kb

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

ChIPseeker is a Bioconductor package for annotating ChIP-seq data analysis. Peak Annotation is performed by the annotatePeak function. The position and strand information of nearest genes are reported, in addition to the distance from the p

Install

npx vskill@latest install biomate-ai/biomate-bioconductor-kb/chipseeker

SKILL.md

The same SKILL.md was published earlier as biomate-ai/biomate-bioconductor-kb/chipseeker.

ChIPseeker — Comprehensive Skill Guide

Domain: ChIP-seq / ATAC-seq
Bioconductor: ChIPseeker
Paper: Yu G, Wang LG, He QY (2015). Bioinformatics, 31(14):2382-2383.

ChIP-seq peak annotation, comparison, and visualization. Annotates peaks to nearest genomic features, generates coverage and TSS profile plots.

Dependencies & Environment

Package-intrinsic requirements from the Bioconductor landing page — reproduce in any R environment.
  • Version: 1.48.0 · Bioconductor: 3.23 · R: ≥ 4.6
  • Imports: AnnotationDbi, aplot, BiocGenerics, boot, dplyr, enrichplot, IRanges, GenomeInfoDb, GenomicRanges, GenomicFeatures, ggplot2, gplots, gtools, magrittr, plotrix, RColorBrewer, rlang, rtracklayer, S4Vectors, scales, tibble, TxDb.Hsapiens.UCSC.hg19.knownGene, yulab.utils
  • Install: BiocManager::install("ChIPseeker")

When to Use

  • Annotate ChIP-seq/ATAC-seq peaks to promoters, exons, introns, intergenic regions
  • Profile read coverage around TSS (transcription start sites)
  • Compare peak sets across experiments
  • Functional enrichment of annotated peaks

Alternatives: HOMER annotatePeaks.pl, GREAT (web tool), GenomicFeatures

Do NOT Use When

  • Differential binding analysis (use DiffBind or csaw).
  • Motif analysis (use MEME-ChIP, HOMER, or universalmotif).
  • De novo peak calling — peaks must already be called (MACS2, HOMER, etc.).

Data Requirements

RequirementDetails
Input FormatBED/narrowPeak files, or GRanges objects of called peaks
Annotation DbTxDb (e.g. TxDb.Hsapiens.UCSC.hg38.knownGene) + OrgDb (org.Hs.eg.db)
Genome MatchPeak genome assembly must match TxDb genome assembly exactly

Installation

r
if (!require("BiocManager", quietly=TRUE))
install.packages("BiocManager")
BiocManager::install("ChIPseeker")
library(ChIPseeker)

Workflows

Peak Annotation and Visualization

Annotate ChIP-seq peaks to genomic features and generate summary plots

Load peaks and annotate
r
library(ChIPseeker)
library(TxDb.Hsapiens.UCSC.hg38.knownGene)
library(org.Hs.eg.db)
txdb <- TxDb.Hsapiens.UCSC.hg38.knownGene
# Read peak file (BED/narrowPeak)
peak <- readPeakFile("treatment_peaks.narrowPeak", as="GRanges")
# Annotate
peakAnno <- annotatePeak(peak,
tssRegion = c(-3000, 3000),
TxDb = txdb,
annoDb = "org.Hs.eg.db")
head(as.data.frame(peakAnno))
Visualize annotation distribution
r
# Pie chart of genomic feature distribution
plotAnnoPie(peakAnno)
# Bar chart
plotAnnoBar(peakAnno)
# Distance to TSS distribution
plotDistToTSS(peakAnno,
title="Distance of peaks to TSS")
TSS coverage profile
r
# Compute tag matrix around TSS
promoter <- getPromoters(TxDb=txdb, upstream=3000, downstream=3000)
tagMatrix <- getTagMatrix(peak, windows=promoter)
# Plot average profile
plotAvgProf(tagMatrix, xlim=c(-3000, 3000),
xlab="Genomic Region (5'->3')",
ylab="Read Count Frequency")
# Heatmap of peak enrichment around TSS
tagHeatmap(tagMatrix, xlim=c(-3000, 3000), color="red")
Pathway enrichment of annotated genes
r
library(clusterProfiler)
anno_df <- as.data.frame(peakAnno)
gene_ids <- unique(anno_df$geneId)
# GO enrichment
ego <- enrichGO(gene_ids, OrgDb=org.Hs.eg.db,
ont="BP", pAdjustMethod="BH",
pvalueCutoff=0.05, qvalueCutoff=0.2)
dotplot(ego)

Key Functions & Parameters

annotatePeak()()

Annotate peaks to genomic features using a TxDb/EnsDb

ParameterDescription
peakGRanges or path to BED/narrowPeak file
tssRegionwindow around TSS to call 'Promoter' (default c(-3000, 3000))
TxDbtranscript database (e.g. TxDb.Hsapiens.UCSC.hg38.knownGene)
annoDbOrgDb for symbol annotation (e.g. 'org.Hs.eg.db')
addFlankGeneInfoadd nearest upstream/downstream gene (default FALSE)
plotAnnoPie() / plotAnnoBar()()

Pie/bar charts of genomic feature distribution

ParameterDescription
xcsAnno object from annotatePeak()
plotTSSProfile() / plotAvgProf()()

Average read density profile around TSS

ParameterDescription
tagMatrixoutput of getTagMatrix()
xlimrange around TSS in bp
xlabx-axis label
getTagMatrix()()

Compute read density matrix around TSS or peak center

ParameterDescription
peakGRanges of peaks
windowsGRanges of windows to compute matrix over
weightColscore column for signal weighting
enrichPathway() / enrichGO()()

Pathway/GO enrichment on annotated genes (via clusterProfiler)

peakHeatmap()()

Heatmap of read coverage around peak centers across samples

Scientific Assumptions

The method assumes the following about your data and experiment:

  • Peaks closest to TSS are assumed to regulate the nearest gene (proximity model — not always correct).
  • Promoter definition (default ±3kb) is arbitrary; adjust based on your experimental context.

Result Interpretation

  • Annotation pie chart: distribution of peaks in promoters, exons, introns, intergenic regions.
  • Promoter peaks: likely direct transcriptional regulation of the nearest gene.
  • Intergenic peaks: may be enhancers or regulatory elements; use 3D chromatin data (Hi-C) to link to genes.
  • TSS enrichment profile: sharp peak at TSS = good signal-to-noise; flat = poor ChIP efficiency.
  • Distance to TSS distribution: narrow distribution near TSS = transcription factor; broad/bimodal = histone mark.

Best Practices

  • Adjust tssRegion=c(-2000, 2000) based on typical promoter definition for your organism.
  • Use annoDb to get gene symbols alongside Entrez IDs in annotations.
  • For ATAC-seq, use the same workflow — peaks annotate open chromatin regions.
  • Compare multiple peak sets with compareAnnotation(list(cond1=anno1, cond2=anno2)).
  • Use vennpeak(peaks_list) for Venn diagrams of peak overlaps.

When to Choose This vs Alternatives

AlternativePrefer this tool whenPrefer alternative when
HOMER annotatePeaks.plYou prefer command-line tools; you need motif analysis alongside annotation.You want R/Bioconductor integration with ggplot2 visualizations and clusterProfiler enrichment.
GREAT (web tool)You want regulatory domain-based gene assignment (better than proximity for enhancers).You want local R-based analysis with custom annotation databases.

Benchmark Evidence

Key studies that have validated or benchmarked this tool:

ChIPseeker provides comprehensive peak annotation and visualization with performance comparable to HOMER's annotatePeaks.

Common Errors & Troubleshooting

Error: TxDb genome does not match peak genome

Cause: Peak file has different genome assembly than TxDb

Fix: Use matching TxDb: e.g. TxDb.Hsapiens.UCSC.hg38.knownGene for hg38 peaks

Additional Notes from Official Documentation

Extracted from the ChIPseeker Bioconductor vignette(s)

2025-11-04

Introduction ChIP profiling ChIP peaks coverage plot Profile of ChIP peaks binding to TSS regions Heatmap of ChIP binding to TSS regions Average Profile of ChIP peaks binding to TSS region Profile of ChIP peaks binding to different regions Binning method for profile of ChIP peaks binding to TSS regions Profile of ChIP peaks binding to body regions Profile of ChIP peaks binding to TTS regions ChIP peaks coverage plot Profile of ChIP peaks binding to TSS regions Heatmap of ChIP binding to TSS regions Average Profile of ChIP peaks binding to TSS region Heatmap of ChIP binding to TSS regions Average Profile of ChIP peaks binding to TSS region Profile of ChIP peaks binding to different regions Binning method for profile of ChIP peaks binding to TSS regions Profile of ChIP peaks binding to body

Abstract

ChIPseeker is an R package for annotating ChIP-seq data analysis. It supports annotating ChIP peaks and provides functions to visualize ChIP peaks coverage over chromosomes and profiles of peaks binding to TSS regions. Comparison of ChIP peak profiles and annotation are also supported. Moreover, it supports evaluating significant overlap among ChIP-seq datasets. Currently, ChIPseeker contains 17,000 bed file information from GEO database. These datasets can be downloaded and compare with user’s own data to explore significant overlap datasets for inferring co-regulation or transcription factor complex for further investigation.

Introduction

Chromatin immunoprecipitation followed by high-throughput sequencing (ChIP-seq) has become standard technologies for genome wide identification of DNA-binding protein target sites. After read mappings and peak callings, the peak should be annotated to answer the biological questions. Annotation also create the possibility of integrating expression profile data to predict gene expression regulation. ChIPseeker (Yu, Wang, and He 2015) was developed for annotating nearest genes and genomic features to peaks. ChIP peak data set comparison is also very important. We can use it as an index to estimate how well biological replications are. Even more important is applying to infer cooperative regulation. If two ChIP seq data, obtained by two different binding proteins, overlap significantly, thes

r
## loading packages
library(ChIPseeker)
library(TxDb.Hsapiens.UCSC.hg19.knownGene)
txdb <- TxDb.Hsapiens.UCSC.hg19.knownGene
library(clusterProfiler)
ChIP profiling

The datasets CBX6 and CBX7 in this vignettes were downloaded from GEO (GSE40740) (Pemberton et al. 2014) while ARmo_0M , ARmo_1nM and ARmo_100nM were downloaded from GEO (GSE48308) (Urbanucci et al. 2012) . ChIPseeker provides readPeakFile to load the peak and store in GRanges object.

r
files <- getSampleFiles()
print(files)
r
## $ARmo_0M
## [1] "/tmp/RtmpfFjEGs/Rinst37108269af0069/ChIPseeker/extdata/GEO_sample_data/GSM1174480_ARmo_0M_peaks.bed.gz"
##
## $ARmo_1nM
## [1] "/tmp/RtmpfFjEGs/Rinst37108269af0069/ChIPseeker/extdata/GEO_sample_data/GSM1174481_ARmo_1nM_peaks.bed.gz"
##
## $ARmo_100nM
## [1] "/tmp/RtmpfFjEGs/Rinst37108269af0069/ChIPseeker/extdata/GEO_sample_data/GSM1174482_ARmo_100nM_peaks.bed.gz"
##
## $CBX6_BF
## [1] "/tmp/RtmpfFjEGs/Rinst37108269af0069/ChIPseeker/extdata/GEO_sample_data/GSM1295076_CBX6_BF_ChipSeq_mergedReps_peaks.bed.gz"
##
## $CBX7_BF
## [1] "/tmp/RtmpfFjEGs/Rinst37108269af0069/ChIPseeker/extdata/GEO_sample_data/GSM1295077_CBX7_BF_ChipSeq_mergedReps_peaks.bed.gz"
ChIP peaks coverage plot

After peak calling, we would like to know the peak locations over the whole genome, covplot function calculates the coverage of peak regions over chromosomes and generate a figure to visualize. GRangesList is also supported and can be used to compare coverage of multiple bed files. When peak is a GRangsList object, user can set the colors directly or by passing a palette to fill_color .

r
covplot(peak, weightCol="V5")
r
covplot(peak, weightCol="V5", chrs=c("chr17", "chr18"), xlim=c(4.5e7, 5e7))
Profile of ChIP peaks binding to TSS regions

This is the start of the file. Read the full SKILL.md on GitHub.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
805
Repository forks
67
7-day trend score
33

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/biomate-ai/biomate-bioconductor-kb/chipseeker/badge)](https://verified-skill.com/skills/biomate-ai/biomate-bioconductor-kb/chipseeker)

Something wrong with this skill or its page? Tell us.