omicverse-single-cell-cellmatch-ontology

Map free-text cell-type labels to canonical Cell Ontology terms.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill turns messy, author-specific cell-type labels into canonical Cell Ontology terms, helping you standardize annotations across cohorts, studies, and species without manually comparing names one by one.

Core Features & Use Cases

  • Plain ontology mapping: Match free-text labels to CL terms with sentence-transformer cosine similarity for clean, descriptive labels.
  • Abbreviation-aware expansion: Use an LLM to expand shorthand labels before mapping when labels are acronym-heavy or underspecified.
  • Species and tissue enrichment: Add Cell Taxonomy context for mouse, human, or tissue-specific cohorts when CL alone is not enough.
  • Use cases: Harmonize annotations after single-cell clustering, validate labels before downstream analysis, and inspect top matches for ambiguous cell names.

Quick Start

Map the cell labels in your AnnData object to Cell Ontology terms with CellOntologyMapper, and enable abbreviation expansion or taxonomy mode if your labels are shorthand or species-specific.

Frequently Asked Questions about omicverse-single-cell-cellmatch-ontology

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

FAQPage Schema
How do I map free-text cell-type labels to Cell Ontology terms in AnnData?

To map free-text cell-type labels to Cell Ontology terms, use CellOntologyMapper on your AnnData object. It applies sentence-transformer cosine similarity matching to translate author-specific annotations into standardized CL terms.

What is the best way to standardize single-cell annotations across different cohorts and species?

The best way to standardize single-cell annotations across cohorts is using species- or tissue-aware mapping. This approach leverages Cell Taxonomy context alongside CL resources to harmonize labels across mouse, human, or tissue-specific cohorts.

Can I expand abbreviation-heavy cell labels before mapping them to ontology terms?

Yes, you can expand abbreviation-heavy cell labels before mapping. The Skill supports optional LLM abbreviation expansion to resolve shorthand labels and acronyms, ensuring accurate sentence-transformer cosine matching against canonical Cell Ontology terms.

Does this cell ontology mapping approach work with mouse and human tissue-specific datasets?

Yes, this cell ontology mapping works with mouse and human tissue-specific datasets. It supports species and tissue enrichment by adding Cell Taxonomy context when standard CL resources are not enough for accurate cell-type standardization.

How do I handle ambiguous cell names during single-cell annotation harmonization?

To handle ambiguous cell names during single-cell annotation harmonization, use configurable thresholding with local ontology embeddings. This allows you to inspect top matches for underspecified labels and filter low-confidence mappings effectively.