single-cell-vector-search

Identify similar cell states across scRNA-seq atlases via embedding similarity.

1|Updated Nov 20, 2025
One-click install
npx skills add https://github.com/tony-zhelonkin/SciAgent-toolkit --skill single-cell-vector-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: single-cell-vector-search
Source: https://github.com/tony-zhelonkin/SciAgent-toolkit/tree/main/skills/single-cell-vector-search
Command: npx skills add https://github.com/tony-zhelonkin/SciAgent-toolkit --skill single-cell-vector-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables researchers to identify biologically similar cell states across large-scale scRNA-seq atlases by embedding-based similarity, enabling cross-study comparisons and phenotype interpretation.

Core Features & Use Cases

  • SCimilarity-based centroid and nearest-neighbor searches for human 10x data
  • Census-based cross-species queries and API-driven analyses
  • End-to-end workflow from embedding to neighbor-based predictions and downstream analyses
  • Guidance on when to use SCimilarity vs Census for robust decision making

Quick Start

Provide a preprocessed AnnData object and run the vector-search workflow to retrieve similar cell states across SCimilarity and Census.

Frequently Asked Questions about single-cell-vector-search

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

FAQPage Schema
How do I find similar cell states across different scRNA-seq studies?

To find similar cell states across scRNA-seq studies, you can use embedding similarity searches against large atlases. This skill applies vector-search to identify matching phenotypes and construct cross-study cohorts using SCimilarity or Census.

When should I use SCimilarity vs Census for single-cell vector search?

Use SCimilarity for centroid and nearest-neighbor searches on human 10x data with local models. Use Census for cross-species queries and API-driven analyses, allowing robust decision making based on your dataset's target organism and scale.

What data preprocessing is required for scRNA-seq embedding similarity searches?

scRNA-seq embedding similarity searches require a preprocessed AnnData object. You must ensure gene alignment, apply lognorm normalization, verify QC metrics, and account for memory constraints before running the vector-search workflow.

Can I perform cross-species scRNA-seq comparisons using embedding search?

Yes, you can perform cross-species scRNA-seq comparisons using the Census API. It enables cross-species queries to identify biologically similar cell states and interpret phenotypes across different organisms within large-scale atlases.

What are the limitations of using KNN for cross-study scRNA-seq analysis?

KNN-based cross-study scRNA-seq analysis is limited by strict gene alignment requirements, lognorm normalization constraints, and memory limitations. Ensure your input data meets QC metrics to avoid failures when searching across large atlases.

How do I derive gene signatures from single-cell embeddings?

You can derive gene signatures from single-cell embeddings by performing centroid-based searches. This identifies similar cell states across scRNA-seq atlases and extracts representative gene expression profiles for phenotype discovery.