omicverse-cross-modal-celltype-transfer

Transfer cell-type labels between AnnData objects using weighted KNN mapping.

13|2|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/omicverse/omicverse-skills --skill omicverse-cross-modal-celltype-transfer-omicverse
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omicverse-cross-modal-celltype-transfer
Source: https://github.com/omicverse/omicverse-skills/tree/main/src/omicverse_skills/skills/cross-modal-celltype-transfer
Command: npx skills add https://github.com/omicverse/omicverse-skills --skill omicverse-cross-modal-celltype-transfer-omicverse

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill turns a cross-modal cell-type annotation notebook into a reusable workflow for transferring labels from a reference AnnData to a query AnnData, so you can avoid manual notebook reassembly and repetitive parameter guessing.

Core Features & Use Cases

  • Weighted KNN training and transfer on a shared latent embedding such as X_glue.
  • Writes predicted labels and uncertainty scores back into the query object for downstream analysis.
  • Optional plotting and MDE-based visualization for quick validation when the required basis or pymde is available.
  • Use case: label ATAC cells from an RNA reference, or reuse the same workflow for other shared-embedding transfer tasks in OmicVerse.

Quick Start

Ask the assistant to transfer cell-type labels from my reference AnnData to my query AnnData using the shared embedding I already computed, then save the predicted labels and uncertainty back into the query object.

Frequently Asked Questions about omicverse-cross-modal-celltype-transfer

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

FAQPage Schema
How do I transfer cell type labels from an RNA reference to a query AnnData?

Transfer cell-type labels from a reference AnnData to a query AnnData using weighted KNN mapping on a shared embedding basis. The Skill writes predicted labels and uncertainty scores directly back into the query object for downstream analysis.

Can I use weighted KNN for cross-modal annotation with shared latent embeddings?

Yes, weighted KNN supports cross-modal annotation workflows on shared latent embeddings such as X_glue. You can label ATAC cells from an RNA reference or reuse the workflow for other shared-embedding transfer tasks within OmicVerse pipelines.

What do I need to set up before transferring cell types between AnnData objects?

You need a reference AnnData and a query AnnData that share a common embedding basis, along with prefix-matched label columns. The Skill requires this shared latent space to execute the weighted KNN mapping and calculate uncertainty.

Does the cell type transfer workflow output uncertainty scores for predictions?

Yes, the cell type transfer workflow outputs uncertainty scores alongside predicted labels. These metrics are written directly into the query AnnData object, allowing you to assess transfer confidence during downstream analysis.

How can I visualize transferred cell type labels in an embedding plot?

Visualize transferred cell type labels using optional plotting and MDE-based visualization. This requires the necessary embedding basis to be available in the query AnnData, and the pymde package must be installed for MDE visualization.

What are the limitations of using weighted KNN for cross-modal cell type transfer?

Weighted KNN cross-modal transfer depends entirely on a precomputed shared embedding basis and prefix-matched label columns. Without a high-quality shared latent space between the reference and query AnnData, the label transfer and uncertainty calculations will not be reliable.