scarches

Map single-cell datasets into reference atlases using scArches.

1|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/Ketomihine/my_skills --skill scarches
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scarches
Source: https://github.com/Ketomihine/my_skills/tree/main/scarches
Command: npx skills add https://github.com/Ketomihine/my_skills --skill scarches

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires scArches, scanpy, scvi-tools, mvTCR, totalVI, and includes references (resource) components.

What problem does it solve?

This Skill enables researchers to integrate and map new single-cell datasets into a curated reference atlas, enabling cross-study analyses, batch-aware embeddings, and consistent downstream interpretation.

Core Features & Use Cases

  • Reference mapping and atlas surgery: align query datasets to an established atlas to transfer annotations and harmonize embeddings.
  • Multi-omics and spatial integration: support scRNA-seq, scATAC-seq, CITE-seq, and spatial chromatin data through scArches workflows.
  • Batch correction and cross-dataset analysis: robust integration of multiple studies, detection of novel cell states, and joint clustering.
  • Use Cases: Build comprehensive reference atlases from multiple studies, map new datasets to existing atlases, and perform label transfer and comparative analysis across conditions.

Quick Start

Prepare reference and query AnnData objects, install scArches and dependencies, select a model (SCVI, TRVAE, scANVI, totalVI, mvTCR, or scPoli), train on the reference dataset, and perform surgery/mapping on the query dataset to obtain integrated embeddings and transferred annotations.

Frequently Asked Questions about scarches

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map a new single-cell dataset to an existing reference atlas?

Mapping new single-cell datasets to a reference atlas involves training a model like SCVI or scANVI on the reference AnnData, then performing atlas surgery to integrate the query dataset and transfer annotations.

What is atlas surgery in single-cell analysis?

Atlas surgery in single-cell analysis is the process of surgically adapting a trained reference model to align query datasets, enabling cross-study integration, batch-aware embeddings, and consistent downstream interpretation.

Can I use scArches for multi-omics integration with scATAC-seq and spatial chromatin data?

Yes, scArches supports multi-omics integration across scRNA-seq, scATAC-seq, CITE-seq, and spatial chromatin data through specialized models like totalVI and mvTCR for cross-study atlas mapping.

Do I need scanpy and scvi-tools to perform batch correction on scRNA-seq data?

Yes, you need the scanpy ecosystem and scvi-tools to perform batch-aware embedding and batch correction on scRNA-seq data, as these frameworks provide the foundational models for scArches mapping workflows.

Which models are available for cross-study integration and label transfer?

Available models for cross-study integration and label transfer include SCVI, TRVAE, scANVI, totalVI, mvTCR, and scPoli, which train on reference datasets and map query data for harmonized embeddings.

What's the best way to detect novel cell states across multiple single-cell studies?

The best way to detect novel cell states across multiple studies is to perform robust batch correction and joint clustering using atlas mapping, which harmonizes embeddings and enables comparative analysis across conditions.