Back to Skills

scvi-tools

Deep learning for single-cell analysis using scvi-tools. This skill should be used when users need (1) data integration and batch correction with scVI/scANVI, (2) ATAC-seq analysis with PeakVI, (3) CITE-seq multi-modal analysis with totalVI, (4) multiome RNA+ATAC analysis with MultiVI, (5) spatial transcriptomics deconvolution with DestVI, (6) label transfer and reference mapping with scANVI/scArches, (7) RNA velocity with veloVI, or (8) any deep learning-based single-cell method. Triggers inclu

23,135stars2,778forksUpdated 7/29/2026

Security Assessment

Safe(95/100)
Security Score95/100

About scvi-tools

scvi-tools is a deep-learning skill for single-cell genomics analysis built on the scvi-tools framework. It helps researchers apply probabilistic, VAE-based models to common single-cell tasks—batch correction and integration, multi-modal analysis, deconvolution, label transfer, and RNA velocity—without having to assemble the modeling code from scratch. It solves the problem of choosing the right model for a given assay and running a correct, reproducible workflow around it.

The skill provides a model-selection guide mapping data types to models (scVI and scANVI for RNA integration and semi-supervised label transfer, PeakVI for scATAC-seq, totalVI for CITE-seq, MultiVI for multiome, DestVI for spatial deconvolution, veloVI for RNA velocity, sysVI for cross-technology batch correction). It ships numerous reference guides and modular Python CLI scripts—prepare_data, train_model, cluster_embed, differential_expression, transfer_labels, integrate_datasets, and validate_adata—that operate on AnnData (.h5ad) files and can be chained into pipelines. Reference material covers QC, binarization, feature selection, training with early stopping, latent-representation extraction, clustering/UMAP/Leiden, and differential accessibility/expression, plus environment and GPU setup and troubleshooting.

Its target users are computational biologists and single-cell researchers doing integration, multi-omics, or reference-mapping analyses, especially those wanting standardized scripts over ad-hoc notebooks. The operations are standard scientific computation on local data files (with optional GPU); there is no networked or destructive behavior beyond reading and writing analysis artifacts.

FAQ

Which models and assays does it cover?

scVI/scANVI (scRNA integration and label transfer), PeakVI (scATAC-seq), totalVI (CITE-seq), MultiVI (multiome RNA+ATAC), DestVI (spatial deconvolution), veloVI (RNA velocity), and sysVI (cross-technology batch correction).

What input format is expected?

AnnData objects stored as .h5ad files; a validate_adata script checks compatibility before modeling, and prepare_data handles QC, filtering, and HVG selection.

Do I need a GPU?

GPU is recommended for training deep models efficiently; the skill includes an environment_setup reference covering installation, GPU, and version details, plus troubleshooting.

Can the scripts be combined into a pipeline?

Yes. The CLI scripts (prepare_data, train_model, cluster_embed, differential_expression, transfer_labels, integrate_datasets) are modular and designed to be chained or modified.

What analyses can I get out of it?

Batch-corrected latent representations, clustering and UMAP embeddings, differential expression or differential accessibility results, label transfer/reference mapping, and RNA velocity, depending on the model.

All Files

22 files
references/atac_peakvi.md9.3 KB
View
references/multiome_multivi.md8.9 KB
View
references/citeseq_totalvi.md10.1 KB
View
references/spatial_deconvolution.md11.2 KB
View
scripts/prepare_data.py5.1 KB
View
SKILL.md7.2 KB
View
references/environment_setup.md6.3 KB
View
references/scarches_mapping.md10.8 KB
View
references/troubleshooting.md10.8 KB
View
scripts/train_model.py11.3 KB
View
references/batch_correction_sysvi.md9.9 KB
View
references/rna_velocity_velovi.md8.6 KB
View
scripts/differential_expression.py6.7 KB
View
references/data_preparation.md6.2 KB
View
scripts/model_utils.py17.0 KB
View
LICENSE.txt10.0 KB
View
references/label_transfer.md10.2 KB
View
scripts/cluster_embed.py6.3 KB
View
scripts/transfer_labels.py7.2 KB
View
references/scrna_integration.md9.6 KB
View
scripts/integrate_datasets.py6.9 KB
View
scripts/validate_adata.py11.9 KB
View

Install scvi-tools

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill