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.