omicverse-single-cell-annotation

Annotate clustered AnnData objects with cell-type labels using CellTypist, GPT-based, or SCSA backends.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Turn clustered single-cell AnnData into reliable cell-type labels without manual label curation by providing a reusable, backend-selectable annotation workflow that encapsulates CellTypist, LLM-based mapping, and SCSA marker-database scoring.

Core Features & Use Cases

  • Multiple backends: Choose CellTypist for pretrained model predictions, gpt4celltype for LLM-driven marker-to-label mapping, or SCSA for database-scoring annotation.
  • Validated output contract: Writes branch-specific label columns and prediction matrices into AnnData and includes validation checks for cluster keys and annotation-ready inputs.
  • Integration use case: Map leiden clusters from a preprocessed AnnData to cell-type labels for downstream visualization and differential analysis.

Quick Start

Annotate a clustered AnnData object by instantiating OmicVerse's Annotation with your AnnData and calling Annotation.annotate with method set to one of celltypist, gpt4celltype, or scsa.

Frequently Asked Questions about omicverse-single-cell-annotation

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

FAQPage Schema
How do I annotate clustered single-cell AnnData with cell-type labels?

To annotate single-cell AnnData, use a reusable workflow that maps clustered data to cell-type labels via CellTypist, GPT-based, or SCSA backends. It writes branch-specific label columns and prediction matrices directly into the AnnData object for downstream analysis.

What is the best way to map leiden clusters to cell types without manual curation?

Mapping leiden clusters to cell types without manual curation is achieved by using automated annotation backends like CellTypist for pretrained model predictions, gpt4celltype for LLM-driven marker-to-label mapping, or SCSA for database-scoring annotation.

Do I need a specific AnnData format for single-cell annotation to work?

Yes, single-cell annotation requires an annotation-ready AnnData object that is preprocessed and clustered. The AnnData must contain a cluster column, and you need backend-specific resources like a CellTypist model file, local SCSA database, or AGI_API_KEY for LLM providers.

Does single-cell annotation work with CellTypist and GPT4celltype backends?

Yes, single-cell annotation supports multiple backends including CellTypist for pretrained model predictions, gpt4celltype for LLM-driven marker-to-label mapping, and SCSA for marker-database scoring, allowing backend-selectable annotation workflows.

What are the limitations of using LLM-based single-cell annotation?

LLM-based single-cell annotation limitations include the requirement of an AGI_API_KEY for LLM providers and the necessity of an annotation-ready AnnData with a pre-existing cluster column, as validation checks enforce these backend-specific resources before processing.

Can I use gpt4celltype for marker-to-label mapping in single-cell RNA-seq workflows?

Yes, you can use gpt4celltype for marker-to-label mapping in single-cell RNA-seq workflows. It serves as an LLM-driven backend within the annotation workflow, generating prompts to map clustered AnnData data to reliable cell-type labels.