tooluniverse-spatial-omics-analysis
Spatial multi-omics interpretation pipeline. Transforms spatially variable genes (SVGs), domain annotations, and tissue context into biological insights via domain-by-domain characterization, cell-type composition, spatial gene expression patterns, RNA+protein+metabolite integration. Use for Visium,
By mims-harvard · 349 installs
npx skills add mims-harvard/tooluniverse --skill tooluniverse-spatial-omics-analysis
Source repository · Upstream listing
Spatial Multi Omics Analysis Pipeline
Comprehensive biological interpretation of spatial omics data. Transforms spatially variable genes (SVGs), domain annotations, and tissue context into actionable biological insights.
KEY PRINCIPLES :
1. Report first approach Create report file FIRST, then populate progressively
2. Domain by domain analysis Characterize each spatial region independently before comparison
3. Gene list centric Analyze user provided SVGs and marker genes with ToolUniverse databases
4. Biological interpretation Go beyond statistics to explain biological meaning of spatial patterns
5. Disease focus Emphasize disease mechanisms and therapeutic opportunities when disease context is provided
6. Evidence grading Grade all evidence as T1 (human/clinical) to T4 (computational)
7. Multi modal thinking Integrate RNA, protein, and metabolite information when available
8. Validation guidance Suggest experimental validation approaches for key findings
9. Source references Every statement must cite tool/database source
10. English first queries Always use English terms in tool calls
LOOK UP, DON'T GUESS
When uncertain about any scientific fact, SEARCH databases first (PubMed, UniProt, ChEMBL, ClinVar, etc.) rather than reasoning from memory. A database verified answer is always more reliable than a guess.
COMPUTE, DON'T DESCRIBE
When analysis requires computation (statistics, data processing, scoring, enrichment), write and run Python code via Bash. Don't describe what you would do — execute it and report actual results. Use ToolUniverse tools to retrieve data, then Python (pandas, scipy, statsmodels, matplotlib) to analyze it.
When to Use This Skill
Apply when users:
Provide spatially variable genes from spatial transcriptomics experiments
Ask about biological interpretation of spatial domains/clusters
Need pathway enrichment of spatial gene expression data
Want to understand cell cell interactions from spatial data
Ask about tumor microenvironment heterogeneity from spatial omics
Need druggable targets in specific spatial regions
Ask about tissue zonation patterns (liver, brain, kidney)
Want to integrate spatial transcriptomics + proteomics data
NOT for : Single gene interpretation (use target research), variant interpretation, drug safety, bulk RNA seq, GWAS analysis.
Input Parameters
Parameter Required Description Example
svgs Yes Spatially variable genes ['EGFR', 'CDH1', 'VIM', 'MYC', 'CD3E']
tissue type Yes Tissue/organ type brain , liver , lung , breast
technology No Spatial omics platform 10x Visium , MERFISH , DBiTplus
disease context No Disease if applicable breast cancer , Alzheimer disease
spatial domains No Domain marker genes dict {'Tumor core': ['MYC','EGFR']}
cell types No Cell types from deconvolution ['Epithelial', 'T cell']
proteins No Proteins detected (multi modal) ['CD3', 'PD L1', 'Ki67']
metabolites No Metabolites (SpatialMETA) ['glutamine', 'lactate']
Spatial Omics Integration Score (0 100)
Data Completeness (0 30) : SVGs (5), Disease context (5), Spatial domains (5), Cell types (5), Multi modal (5), Literature (5)
Biological Insight (0 40) : Pathway enrichment FDR<0.05 (10), Cell cell interactions (10), Disease mechanism (10), Druggable targets (10)
Evidence Quality (0 30) : Cross database validation 3+ DBs (10), Clinical validation (10), Literature support (10)
Score Tier Interpretation
80 100 Excellent Comprehensive characterization, strong insights, druggable targets
60 79 Good Good pathway/interaction analysis, some therapeutic context
40 59 Moderate Basic enrichment, limited domain comparison
0 39 Limited Minimal data, gene level annotation only
Evidence Grading
Tier Criteria Examples
[T1] Direct human/clinical evidence FDA approved drug, validated biomarker
[T2] Experimental evidence Validated spatial pattern, known L R pair
[T3] Computational/database evidence PPI prediction, pathway enrichment
[T4] Annotation/prediction only GO annotation, text mined association
Analysis Phases Overview
Phase 0: Input Processing & Disambiguation (ALWAYS FIRST)
Resolve tissue/disease identifiers, establish analysis context. Get MONDO/EFO IDs for disease queries.
Tools: OpenTargets get disease id description by name , OpenTargets get disease description by efoId , HPA search genes by query
Phase 1: Gene Characterization
Resolve gene IDs, annotate functions, tissue specificity, subcellular localization.
Tools: MyGene query genes , UniProt get function by accession , HPA get subcellular location , HPA get rna expression by source , HPA get comprehensive gene details by ensembl id , HPA get cancer prognostics by gene , UniProtIDMap gene to uniprot
Phase 2: Pathway & Functional Enrichment
Identify enriched pathways globally and per domain. Filter FDR < 0.05.
Tools: STRING functional enrichment (PRIMARY), ReactomeAnalysis pathway enrichment , GO get annotations for gene , kegg search pathway , WikiPathways search
Phase 3: Spatial Domain Characterization
Characterize each domain biologically, assign cell types from markers, compare domains.
Tools: Phase 2 tools + HPA get biological processes by gene , HPA get protein interactions by gene
Phase 4: Cell Cell Interaction Inference
Predict communication from spatial patterns. Check ligand receptor pairs across domains.
Tools: STRING get interaction partners , STRING get protein interactions , intact search interactions , Reactome get interactor , DGIdb get drug gene interactions
Phase 5: Disease & Therapeutic Context
Connect to disease mechanisms, identify druggable targets, find clinical trials.
Tools: OpenTargets get associated targets by disease efoId , OpenTargets get target tractability by ensemblID , OpenTargets get associated drugs by target ensemblID , search clinical trials , DGIdb get gene druggability , civic search genes
Phase 6: Multi Modal Integration
Integrate protein/RNA/metabolite data. Compare spatial RNA with protein detection.
Tools: HPA get subcellular location , HPA get rna expression in specific tissues , Reactome map uniprot to pathways , kegg get pathway info
Phase 7: Immune Microenvironment (Cancer/Inflammation only)
Classify immune cells, check checkpoint expression, assess Hot vs Cold vs Excluded patterns.
Tools: STRING functional enrichment , OpenTargets get target tractability by ensemblID , iedb search epitopes
Phase 8: Literature & Validation Context
Search published evidence, suggest validation experiments (smFISH, IHC, PLA).
Tools: PubMed search articles , openalex literature search
Data Discovery: HuBMAP Spatial Atlas Tools
Use HuBMAP tools to find published spatial biology reference datasets for comparison, validation, or cross study analysis.
Tool Purpose Key Parameters
HuBMAP search datasets Search published spatial datasets by organ/assay/keyword organ (code: "LK"=Kidney, "BR"=Brain, "LU"=Lung, etc.), dataset type ("RNAseq", "CODEX", "MALDI"), query , limit
HuBMAP list organs List all available organs with codes and UBERON IDs (no required params)
HuBMAP get dataset Get detailed metadata for a specific HuBMAP dataset hubmap id (e.g. "HBM626.FHJD.938")
When to use : Phase 0 (find reference datasets for the tissue), Phase 8 (cross reference findings with published HuBMAP atlas data).
See phase procedures.md for detailed workflows, decision logic, and tool parameter specifications per phase.
Report Structure
Create file: {tissue} {disease} spatial omics report.md
See report template.md for full template with table structures.
Completeness Checklist
[ ] Gene ID resolution complete
[ ] Tissue expression patterns analyzed (HPA)
[ ] Subcellular localization checked (HPA)
[ ] Pathway enrichment complete (STRING + Reactome)
[ ] GO enrichment complete (BP + MF + CC)
[ ] Spatial domains characterized individually
[ ] Domain comparison performed
[ ] PPI analyzed (STRING)
[ ] Ligand receptor pairs identified
[ ] Disease associations checked (OpenTargets)
[ ] Druggable targets identified
[ ] Multi modal integration performed (if data available)
[ ] Immune microenvironment characterized (if relevant)
[ ] Literature search completed
[ ] Validation recommendations provided
[ ] Integration Score calculated
[ ] Executive summary written
[ ] All sections have source citations
Common Use Cases
1. Cancer Spatial Heterogeneity : Visium with tumor/stroma/immune domains pathways, immune infiltration, druggable targets, checkpoints
2. Brain Tissue Zonation : MERFISH with neuronal subtypes synaptic signaling, receptors, hippocampal zonation
3. Liver Metabolic Zonation : Periportal vs pericentral CYP450, Wnt gradient, drug metabolism enzymes
4. Tumor Immune Interface : DBiTplus RNA+protein checkpoint L R pairs, immune exclusion, multi modal concordance
5. Developmental Patterns : Morphogen gradients (Wnt, BMP, FGF, SHH), TF patterns, cell fate genes
6. Disease Progression : Disease gradient inflammatory response, neuronal loss, therapeutic windows
Reference Files
phase procedures.md Detailed phase workflows, decision logic, tool usage per phase
tool reference.md Tool parameter names, response formats, fallback strategies, limitations
reference data.md Cell type markers, ligand receptor pairs, immune checkpoint reference
report template.md Full report template with all table structures
test spatial omics.py Test suite
Summary
Spatial Multi Omics Analysis provides:
1. Gene characterization (ID resolution, function, localization, tissue expression)
2. Pathway & functional enrichment (STRING, Reactome, GO, KEGG)
3. Spatial domain characterization (per domain and cross domain)
4. Cell cell interaction inference (PPI, ligand receptor, signaling)
5. Disease & therapeutic context (disease genes, druggable targets, trials)
6. Multi modal integration (RNA protein concordance, metabolic pathways)
7. Immune microenvironment (cell types, checkpoints, immunotherapy)
8. Literature context & validation recommendations
Outputs : Markdown report with Spatial Omics Integration Score (0 100)
Uses : 70+ ToolUniverse tools across 9 analysis phases
Time : ~10 20 minutes depending on gene list size