biomate-ai/biomate-bioconductor-kb/asurat
Claude Code and agent skill by biomate-ai/biomate-bioconductor-kb
- community
Checking that the SKILL.md file is still in the repository.
ASURAT is a software for single-cell data analysis. Using ASURAT, one can simultaneously perform unsupervised clustering and biological interpretation in terms of cell type, disease, biological process, and signaling pathway activity. Inputting a single-cell RNA-seq data and knowledge-based databases, such as Cell Ontology, Gene Ontology, KEGG, etc., ASURAT transforms gene expression tables into original multivariate tables, termed sign-by-sample matrices (SSMs).
Install
npx vskill@latest install biomate-ai/biomate-bioconductor-kb/asuratSKILL.md
The same SKILL.md was published earlier as biomate-ai/biomate-bioconductor-kb/asurat.
ASURAT
Workflows
Standard Workflow
Perform single-cell RNA-seq preprocessing, functional sign creation from databases, sign-by-sample matrix generation, clustering, and multifaceted visualization.
Input: A raw count SingleCellExperiment object and knowledge-based databases. Output: A SingleCellExperiment object containing a sign-by-sample matrix (SSM) with computed separation indices.
When to Use
- To simultaneously perform unsupervised clustering and biological interpretation of single-cell RNA-seq data using functional gene sets from databases like Cell Ontology, Gene Ontology, or KEGG.
- To transform normalized-and-centered gene expression matrices into sign-by-sample matrices (SSMs) using
makeSignMatrix. - To identify significant biological markers (signs) for cell clusters using non-parametric separation indices computed via
compute_sepI_all. - To visualize multifaceted single-cell datasets across multiple sign-by-sample matrices and gene expression levels simultaneously using
plot_multiheatmaps.
When NOT to Use
- For standard gene-level-only clustering without functional database integration, use
scranorSeuratbecause ASURAT is specifically designed for sign-based (gene set) multivariate analysis. - For datasets lacking reliable functional annotations or established gene sets, use standard unsupervised clustering because ASURAT relies on knowledge-based databases to define signs.
Data Requirements
- Input format:
SingleCellExperimentobject containing raw counts inassays(sce)$counts. - Structure: Row names must be gene symbols (e.g.,
Symbol_TENx) and column names must be cell barcodes. - Normalization state: Requires log-normalized and centered expression data (stored in
assay(sce, "centered")) to compute gene expression correlation matrices.
Key Parameters
- mitochondria_symbol ("^MT-"): Regular expression to identify mitochondrial genes for quality control.
- min_nsamples (10): Minimum number of non-zero expressing cells required to keep a gene.
- min_meannReads (0.05): Minimum mean read count across samples required to keep a gene.
- min_ngenes (2): Minimal number of genes in a functional gene set to be kept.
- max_ngenes (1000): Maximal number of genes in a functional gene set to be kept.
- th_posi (0.30): Positive correlation coefficient threshold for clustering gene sets.
- th_nega (-0.30): Negative correlation coefficient threshold for clustering gene sets.
- weight_strg (0.5): Weight parameter for strongly correlated gene sets (SCG) in SSM creation.
Best Practices
- Add metadata to both rows and columns using
add_metadatabefore performing quality control filtering. - Perform log-normalization and center the data by subtracting the mean expression levels across cells before computing correlation matrices.
- Filter out redundant signs using semantic similarity matrices with
remove_signs_redundantto simplify the downstream analysis. - Use
compute_sepI_allto find cluster-specific signs instead of standard parametric tests, as row vectors of SSMs are centered.
Common Pitfalls
- Using slot name "log-normalized" for
altExp(sce): This can cause errors when converting to Seurat objects usingas.Seurat. Fix by using standard slot names like "logcounts". - Setting excessive cutoff values in
remove_samples: This can produce biased results. Carefully inspect the distribution ofnReadsandnGenesbefore setting thresholds.
Alternatives
Seuratfor standard graph-based clustering and cell cycle scoring.scaterfor standard single-cell preprocessing and visualization.ComplexHeatmapfor general high-dimensional heatmap plotting.
Citations
- Iida K (2026), "ASURAT: Functional sign-based single-cell analysis".
References
- Homepage: bioconductor.org/packages/asurat
- Vignette: bioconductor.org/packages/release/bioc/vignettes/asurat/inst/doc/asurat.html
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
- SKILL.md in the repositoryCheckingskills/transcriptomics/asurat/SKILL.md
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
[](https://verified-skill.com/skills/biomate-ai/biomate-bioconductor-kb/asurat)