cellagent-annotation

Name: cellagent-annotation
Author: swaruplab/operon

$npx mdskill add swaruplab/operon/cellagent-annotation

Annotates scRNA-seq clusters with cell types and confidence scores.

Automates cell type annotation without manual curation.
Generates and executes Scanpy/Seurat code autonomously.
Uses marker genes, species, tissue context, and optional atlases.
Outputs a table with cluster, label, confidence, and supporting markers.

SKILL.md

.github/skills/cellagent-annotationView on GitHub ↗

---
name: cellagent-annotation
description: Cell tagger
keywords:
  - single-cell
  - markers
  - annotation
  - confidence
  - tissue
measurable_outcome: Label every provided cluster with a cell type + confidence + marker evidence (or "ambiguous") within 15 minutes per dataset.
license: MIT
metadata:
  author: CellAgent Team
  version: "1.0.0"
compatibility:
  - system: Python 3.9+
allowed-tools:
  - run_shell_command
  - read_file
---

# CellAgent Annotation

Use CellTypeAgent to interpret marker genes, annotate scRNA-seq clusters, and coordinate multi-agent workflows for downstream analysis.

## When to Use
- Automated annotation of scRNA-seq datasets without manual curation.
- Multi-step workflows (QC → clustering → annotation → DE analysis).
- Integrating multiple batches requiring consistent labeling.

## Core Capabilities
1. **Planning:** Multi-agent planner decomposes analysis goals into steps.
2. **Tool execution:** Generates Scanpy/Seurat code and runs it autonomously.
3. **Self-correction:** Detects execution errors and retries with fixes.

## Workflow
1. Gather marker lists per cluster, plus species/tissue context and optional atlas references.
2. Run CellTypeAgent (`pip install -r requirements.txt` then `python repo/main.py --data data.h5ad --goal annotate`).
3. Review outputs for supporting markers; downgrade ambiguous clusters when signals conflict.
4. Produce final table (cluster, label, confidence, supporting markers, notes) and cite references when used.

## Example Usage
```bash
python3 Skills/Genomics/Single_Cell/CellAgent/repo/main.py --data "./data.h5ad" --goal "annotate"
```

## Guardrails
- Avoid over-specific lineages if markers overlap; default to broader types.
- Flag clusters showing multiple signatures for manual review.
- Respect species/tissue differences when interpreting markers.

## References
- README + upstream paper (Mao et al., 2025 / arXiv 2407.09811).

More from swaruplab/operon

Skill	Description
agentd-drug-discovery	Use the AgentD workflow to mine evidence, design molecules, and rank candidates with SAR plus ADMET annotations for early drug discovery tasks.
alphafold-database	Access AlphaFold 200M+ AI-predicted protein structures. Retrieve structures by UniProt ID, download PDB/mmCIF files, analyze confidence metrics (pLDDT, PAE), for drug discovery and structural biology.
antibody-design-agent	An advanced agent for de novo antibody design and optimization using state-of-the-art protein language models (MAGE, RFdiffusion).
archr	Single-cell ATAC-seq analysis with ArchR (R). The mature R-based scATAC pipeline — Arrow files, doublet inference, iterative LSI + Harmony, clustering, gene scores, MACS2 peak calling, motif enrichment, chromVAR deviations, footprinting, scRNA-seq integration (label transfer), trajectory analysis (built-in + Monocle3 + Slingshot), and ArchR's interactive genome browser. Sister protocol to snapatac2 — pick this for established R workflows.
automated-bioinformatics-pipelines	Pipeline maestro
autonomous-biomedical-agent	Autonomous biomedical AI agent framework for executing complex research tasks across genomics, drug discovery, molecular biology, and clinical analysis. Use this skill when conducting multi-step biomedical research including CRISPR screening design, single-cell RNA-seq analysis, ADMET prediction, GWAS interpretation, rare disease diagnosis, or lab protocol optimization. Leverages LLM reasoning with code execution and integrated biomedical databases.
autonomous-oncology-agent	Precision Oncology
basecalling	Convert raw Nanopore signal data (FAST5/POD5) to nucleotide sequences using Dorado basecaller. Covers model selection, GPU acceleration, modified base detection, and quality filtering. Use when processing raw Nanopore data before alignment. Note: Guppy is deprecated; use Dorado for all new analyses.
batch-processing	Process multiple sequence files in batch using Biopython. Use when working with many files, merging/splitting sequences, or automating file operations across directories.
bindingdb-database	Query BindingDB for measured drug-target binding affinities (Ki, Kd, IC50, EC50). Search by target (UniProt ID), compound (SMILES/name), or pathogen. Essential for drug discovery, lead optimization, polypharmacology analysis, and structure-activity relationship (SAR) studies.