biomate-ai/biomate-bioconductor-kb/aucell

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

Trust tier 3
  • community
Source check pending

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

AUCell allows to identify cells with active gene sets (e.g. signatures, gene modules...) in single-cell RNA-seq data. AUCell uses the "Area Under the Curve" (AUC) to calculate whether a critical subset of the input gene set is enriched with

Install

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

SKILL.md

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

AUCell

Dependencies & Environment

Package-intrinsic requirements from the Bioconductor landing page — reproduce in any R environment.
  • Version: 1.34.0 · Bioconductor: 3.23 · R: ≥ 4.6
  • Depends: DelayedMatrixStats, data.table, GSEABase, Matrix, mixtools, R.utils, SummarizedExperiment, BiocGenerics
  • Imports: DelayedArray, DelayedMatrixStats, data.table, GSEABase, Matrix, mixtools, R.utils, SummarizedExperiment, BiocGenerics
  • Install: BiocManager::install("AUCell")

When to Use

  • Single-Cell Signature Scoring: Identifying cells with active gene sets, signatures, or modules in single-cell RNA-seq data using AUCell_run.
  • Normalization-Independent Scoring: Scoring gene sets across cells independently of the gene expression units and normalization procedures by building rank-based profiles with AUCell_buildRankings.
  • Cell State Classification: Classifying cell types or states by exploring the bimodal distribution of signature activity scores and setting assignment thresholds with AUCell_exploreThresholds.
  • Dimensionality Reduction Overlay: Visualizing the activity of specific gene signatures across cell populations by coloring t-SNE or UMAP plots using AUCell_plotTSNE.

When NOT to Use

  • Bulk RNA-seq GSEA: For bulk RNA-seq gene set enrichment analysis, use fgsea instead because AUCell is specifically optimized for evaluating signatures on individual cells in highly sparse single-cell data.
  • Differential Expression of Single Genes: For differential expression of individual genes between clusters, use edgeR or scran instead because AUCell summarizes multi-gene signatures into a single AUC score per cell.

Data Requirements

  • Expression Matrix: A single-cell gene expression matrix with genes as rows and cells as columns. Ideally stored in a sparse format (e.g., dgCMatrix).
  • Gene Sets: A list of gene sets or signatures to test, provided as a GeneSetCollection or a standard R list of character vectors.

Key Parameters

  • exprMatrix: The input single-cell gene expression matrix.
  • geneSets: The gene sets or signatures to evaluate.
  • aucMaxRank: The number or percentage of top-ranked genes to use for calculating the AUC (default is often 5% of expressed genes).
  • plotStats: Logical in AUCell_buildRankings to plot the histogram of the number of detected genes per cell.
  • plotHist: Logical in AUCell_exploreThresholds to automatically plot all AUC histograms.
  • assign: Logical in AUCell_exploreThresholds to return the list of cells with an AUC value over the calculated threshold.
  • aucThr: Specific numeric threshold to manually set when plotting individual histograms with AUCell_plotHist.

Best Practices

  • Convert the expression matrix to a sparse format (dgCMatrix) before running AUCell to significantly save memory.
  • Check the distribution of detected genes per cell using plotGeneCount or plotStats=TRUE to ensure most cells have enough detected genes to support the chosen aucMaxRank.
  • Do not rely blindly on automatic threshold selection; always manually inspect the AUC histograms generated by AUCell_exploreThresholds to ensure the bimodal distribution aligns with biological expectations.
  • Save the intermediate cells_rankings object if you plan to test additional gene sets later, as building rankings is the most computationally intensive step.

Common Pitfalls

  • Memory Exhaustion: Running AUCell_buildRankings on large datasets with dense matrices can exceed RAM. Fix by converting the input matrix to dgCMatrix and utilizing parallel processing via BPPARAM.
  • Inappropriate aucMaxRank: Setting aucMaxRank higher than the number of genes detected in most cells includes noise from tied zero-expression genes. Fix by checking the quantiles from AUCell_buildRankings and adjusting aucMaxRank accordingly.
  • Small Gene Sets: Using very small gene sets (<10 genes) makes it difficult to establish a stable bimodal distribution, often resulting in cells with an AUC of 0. Fix by using larger, more robust gene sets (100-2k genes) when possible.

Alternatives

  • UCell: Uses Mann-Whitney U statistics to score gene signatures, differing by being specifically optimized for lower memory consumption on extremely large single-cell datasets.
  • GSVA: Calculates sample-wise enrichment, differing by using a kernel density estimate that is computationally heavier and less suited for the sparsity of single-cell scales.

Citations

  • Aibar et al. (2017) SCENIC: single-cell regulatory network inference and clustering. Nature Methods. doi: 10.1038/nmeth.4463

References

  • Homepage: https://bioconductor.org/packages/AUCell
  • Vignette: https://bioconductor.org/packages/release/bioc/vignettes/AUCell/inst/doc/AUCell.html

<!-- biomate-cta -->


Run this on BioMate

This skill is the knowledge layer — when, why, and how to use aucell. To run this analysis on your own data with managed compute, automated QC, and reproducible outputs, use [BioMate](https://www.biomate.ai?ref=kb&pkg=aucell) — free to start.

▶ [Open `aucell` on BioMate →](https://www.biomate.ai?ref=kb&pkg=aucell)

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

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/aucell/badge)](https://verified-skill.com/skills/biomate-ai/biomate-bioconductor-kb/aucell)

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