tooluniverse-spatial-transcriptomics

Analyze spatial transcriptomics data to identify tissue domains, spatially variable genes, and cell-cell interactions.

1.7k|254|Updated Mar 3, 2025
One-click install
npx skills add https://github.com/mims-harvard/ToolUniverse --skill tooluniverse-spatial-transcriptomics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tooluniverse-spatial-transcriptomics
Source: https://github.com/mims-harvard/ToolUniverse/tree/main/plugins/tooluniverse/skills/tooluniverse-spatial-transcriptomics
Command: npx skills add https://github.com/mims-harvard/ToolUniverse --skill tooluniverse-spatial-transcriptomics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires scanpy, squidpy, cell2location, scikit-learn, matplotlib, pandas, requests, tooluniverse, and includes references (resource) components.

What problem does it solve?

Spatial transcriptomics data combines gene expression with tissue coordinates, but turning raw Visium, MERFISH, or Slide-seq output into biological insight requires a long chain of QC, normalization, spatial clustering, deconvolution, and ligand-receptor analysis that is easy to get wrong. This Skill provides a structured eight-phase workflow that guides an AI agent through the entire analysis, from data import to a publication-style report.

Core Features & Use Cases

  • Spatial domain identification: Graph-based Leiden clustering with spatial constraints (squidpy) segments tissue into coherent expression domains with marker genes.
  • Spatially variable gene detection: Moran's I autocorrelation testing (FDR < 0.05) classifies genes into gradient, hotspot, boundary, and periodic patterns.
  • Cell type deconvolution and communication: Integrates scRNA-seq references via Cell2location, Tangram, or SPOTlight, and maps ligand-receptor interactions using OmniPath and squidpy ligrec.
  • Dataset discovery: HuBMAP, OmicsDI, GEO, and CELLxGENE tools locate published spatial datasets for reference or validation.
  • Use Case: Given a 10x Visium breast cancer section, the workflow identifies tumor core, invasive margin, and immune infiltrate domains, maps T cell exclusion, and highlights PD-L1/PD-1 checkpoint hotspots at the tumor-immune interface.

Quick Start

Analyze my 10x Visium dataset in the spaceranger output folder to identify spatial domains and spatially variable genes, then generate a full tissue report.

Frequently Asked Questions about tooluniverse-spatial-transcriptomics

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

FAQPage Schema
How do I identify spatially variable genes in Visium data?

Use Moran's I spatial autocorrelation via squidpy's spatial_autocorr function after building a spatial neighbor graph. Filter genes by FDR < 0.05, then classify significant genes into gradient, hotspot, boundary, or periodic patterns.

How to integrate spatial transcriptomics with scRNA-seq data?

Use cell type deconvolution methods such as Cell2location (recommended for Visium), Tangram, or SPOTlight. These map single-cell reference annotations onto spatial spots, producing cell type fraction estimates per spot that you validate with marker genes.

What QC thresholds should I use for 10x Visium spots?

Filter spots with fewer than 200 detected genes, fewer than 500 UMI counts, and more than 20% mitochondrial reads. Also verify spatial coordinate alignment against the tissue histology image before downstream analysis.

Does this workflow support MERFISH and Slide-seq data?

Yes, the workflow supports MERFISH, seqFISH, Slide-seq, STARmap, and Xenium alongside 10x Visium. Imaging-based platforms offer single-cell resolution with targeted gene panels, while Visium and Slide-seq provide genome-wide coverage.

What are the limitations of Visium spatial transcriptomics analysis?

Visium spots are 55um and contain roughly 50 cells, so resolution is not single-cell. Imaging methods cover limited gene panels, most platforms capture only 2D sections, and deconvolution quality depends heavily on the scRNA-seq reference used.