name: 'spatial-epigenomics-agent'
description: 'AI-powered spatial epigenomics analysis combining chromatin accessibility, histone modifications, and DNA methylation with spatial coordinates for tissue architecture mapping.'
measurable_outcome: Execute skill workflow successfully with valid output within 15 minutes.
allowed-tools:
- read_file
- run_shell_command
Spatial Epigenomics Agent
The Spatial Epigenomics Agent analyzes spatial epigenomic data combining chromatin accessibility (ATAC-seq), histone modifications (CUT&Tag), and DNA methylation with spatial coordinates. It maps regulatory landscapes across tissue architecture to understand cell-state regulation in spatial context.
When to Use This Skill
- When analyzing spatial ATAC-seq data (Slide-seq + ATAC, DBiT-seq).
- To map chromatin accessibility across tissue microenvironments.
- For spatial profiling of histone modifications (H3K27ac, H3K4me3, H3K27me3).
- When integrating spatial epigenomics with spatial transcriptomics.
- To identify spatially-variable regulatory elements and enhancers.
Core Capabilities
Spatial ATAC Analysis: Process spatial chromatin accessibility data to identify open chromatin regions with spatial coordinates.
Spatial CUT&Tag: Analyze spatially-resolved histone modification profiles (H3K27ac for enhancers, H3K4me3 for promoters).
Spatial Methylation: Map DNA methylation patterns across tissue sections using spatial bisulfite methods.
Multi-Modal Integration: Combine spatial epigenomics with spatial transcriptomics for regulatory network inference.
Regulatory Element Mapping: Identify spatially-variable enhancers, promoters, and silencers.
3D Chromatin Organization: Integrate with MERFISH/seqFISH+ for spatial chromatin organization.
Technologies Supported
| Technology |
Epigenetic Mark |
Resolution |
Method |
| Spatial-ATAC-seq |
Open chromatin |
~10-50μm |
Microfluidic barcoding |
| DBiT-seq |
ATAC + expression |
~10μm |
Deterministic barcoding |
| Spatial-CUT&Tag |
Histone marks |
~50μm |
Cleavage under targets |
| Spatial-MethylSeq |
DNA methylation |
Variable |
Bisulfite conversion |
| MERFISH + epigenetics |
3D organization |
Single-cell |
Imaging-based |
Workflow
Input: Spatial epigenomics data (BAM files + spatial coordinates) or processed peak matrices.
Preprocessing: Alignment, deduplication, peak calling with spatial awareness.
Spatial Clustering: Identify spatial domains with similar epigenetic profiles.
Peak Annotation: Map peaks to genomic features (promoters, enhancers, gene bodies).
Motif Analysis: Identify transcription factor binding motifs in spatially-variable peaks.
Integration: Combine with expression data for regulatory inference.
Output: Spatial peak maps, regulatory networks, domain annotations.
Example Usage
User: "Analyze this spatial ATAC-seq dataset to identify spatially-variable regulatory elements in the tumor microenvironment."
Agent Action:
python3 Skills/Genomics/Spatial_Epigenomics_Agent/spatial_epigenomics.py \
--input spatial_atac_fragments.tsv.gz \
--coordinates spot_coordinates.csv \
--peaks macs2_peaks.bed \
--spatial_variable true \
--motif_db jaspar_2024 \
--integrate_with spatial_rna.h5ad \
--output spatial_epi_results/
Analysis Modules
1. Spatial Peak Calling
- Adapted MACS2/Genrich for spatial data
- Spatial autocorrelation of accessibility
- Pseudo-bulk and single-spot approaches
2. Spatial Domain Detection
- Graph-based clustering (Leiden, Louvain)
- Hidden Markov Random Fields
- Deep learning segmentation
3. Transcription Factor Analysis
- ChromVAR for TF activity scores
- SCENIC+ for spatial regulon inference
- Motif enrichment in spatial domains
4. Enhancer-Gene Linking
- Activity-by-contact (ABC) model adaptation
- Spatial correlation of enhancer accessibility with gene expression
- Chromatin loop integration
Integration with Spatial Transcriptomics
Spatial ATAC-seq Spatial RNA-seq
| |
v v
Peak Matrix Expression Matrix
| |
+--------> Integration <-+
|
v
Regulatory Network
(Enhancer -> TF -> Gene)
Key Metrics
| Metric |
Description |
Typical Range |
| TSS Enrichment |
Signal at transcription start sites |
>4 good quality |
| FRiP |
Fraction reads in peaks |
>30% |
| Spatial autocorrelation |
Moran's I for epigenetic features |
0.2-0.8 |
| Spots per gene |
Detection sensitivity |
100-500 |
Prerequisites
- Python 3.10+
- SnapATAC2, ArchR for ATAC analysis
- Squidpy, Scanpy for spatial analysis
- MACS2/Genrich for peak calling
Related Skills
- Spatial_Transcriptomics - For gene expression spatial mapping
- Epigenomics_MethylGPT_Agent - For methylation analysis
- Single_Cell - For non-spatial epigenomics
Applications
- Tumor Microenvironment: Map regulatory programs across tumor-stroma boundary
- Development: Track enhancer activation during tissue morphogenesis
- Neuroanatomy: Brain region-specific regulatory landscapes
- Disease Mechanisms: Spatial dysregulation in pathology
Author
AI Group - Biomedical AI Platform
1---2name: spatial-epigenomics-agent3description: <!--4---5<!--6# COPYRIGHT NOTICE7# This file is part of the "Universal Biomedical Skills" project.8# Copyright (c) 2026 MD BABU MIA, PhD <md.babu.mia@mssm.edu>9# All Rights Reserved.10#11# This code is proprietary and confidential.12# Unauthorized copying of this file, via any medium is strictly prohibited.13#14# Provenance: Authenticated by MD BABU MIA1516-->1718---19name: 'spatial-epigenomics-agent'20description: 'AI-powered spatial epigenomics analysis combining chromatin accessibility, histone modifications, and DNA methylation with spatial coordinates for tissue architecture mapping.'21measurable_outcome: Execute skill workflow successfully with valid output within 15 minutes.22allowed-tools:23 - read_file24 - run_shell_command25---262728# Spatial Epigenomics Agent2930The **Spatial Epigenomics Agent** analyzes spatial epigenomic data combining chromatin accessibility (ATAC-seq), histone modifications (CUT&Tag), and DNA methylation with spatial coordinates. It maps regulatory landscapes across tissue architecture to understand cell-state regulation in spatial context.3132## When to Use This Skill3334* When analyzing spatial ATAC-seq data (Slide-seq + ATAC, DBiT-seq).35* To map chromatin accessibility across tissue microenvironments.36* For spatial profiling of histone modifications (H3K27ac, H3K4me3, H3K27me3).37* When integrating spatial epigenomics with spatial transcriptomics.38* To identify spatially-variable regulatory elements and enhancers.3940## Core Capabilities41421. **Spatial ATAC Analysis**: Process spatial chromatin accessibility data to identify open chromatin regions with spatial coordinates.43442. **Spatial CUT&Tag**: Analyze spatially-resolved histone modification profiles (H3K27ac for enhancers, H3K4me3 for promoters).45463. **Spatial Methylation**: Map DNA methylation patterns across tissue sections using spatial bisulfite methods.47484. **Multi-Modal Integration**: Combine spatial epigenomics with spatial transcriptomics for regulatory network inference.49505. **Regulatory Element Mapping**: Identify spatially-variable enhancers, promoters, and silencers.51526. **3D Chromatin Organization**: Integrate with MERFISH/seqFISH+ for spatial chromatin organization.5354## Technologies Supported5556| Technology | Epigenetic Mark | Resolution | Method |57|------------|-----------------|------------|--------|58| Spatial-ATAC-seq | Open chromatin | ~10-50μm | Microfluidic barcoding |59| DBiT-seq | ATAC + expression | ~10μm | Deterministic barcoding |60| Spatial-CUT&Tag | Histone marks | ~50μm | Cleavage under targets |61| Spatial-MethylSeq | DNA methylation | Variable | Bisulfite conversion |62| MERFISH + epigenetics | 3D organization | Single-cell | Imaging-based |6364## Workflow65661. **Input**: Spatial epigenomics data (BAM files + spatial coordinates) or processed peak matrices.67682. **Preprocessing**: Alignment, deduplication, peak calling with spatial awareness.69703. **Spatial Clustering**: Identify spatial domains with similar epigenetic profiles.71724. **Peak Annotation**: Map peaks to genomic features (promoters, enhancers, gene bodies).73745. **Motif Analysis**: Identify transcription factor binding motifs in spatially-variable peaks.75766. **Integration**: Combine with expression data for regulatory inference.77787. **Output**: Spatial peak maps, regulatory networks, domain annotations.7980## Example Usage8182**User**: "Analyze this spatial ATAC-seq dataset to identify spatially-variable regulatory elements in the tumor microenvironment."8384**Agent Action**:85```bash86python3 Skills/Genomics/Spatial_Epigenomics_Agent/spatial_epigenomics.py \87 --input spatial_atac_fragments.tsv.gz \88 --coordinates spot_coordinates.csv \89 --peaks macs2_peaks.bed \90 --spatial_variable true \91 --motif_db jaspar_2024 \92 --integrate_with spatial_rna.h5ad \93 --output spatial_epi_results/94```9596## Analysis Modules9798**1. Spatial Peak Calling**99- Adapted MACS2/Genrich for spatial data100- Spatial autocorrelation of accessibility101- Pseudo-bulk and single-spot approaches102103**2. Spatial Domain Detection**104- Graph-based clustering (Leiden, Louvain)105- Hidden Markov Random Fields106- Deep learning segmentation107108**3. Transcription Factor Analysis**109- ChromVAR for TF activity scores110- SCENIC+ for spatial regulon inference111- Motif enrichment in spatial domains112113**4. Enhancer-Gene Linking**114- Activity-by-contact (ABC) model adaptation115- Spatial correlation of enhancer accessibility with gene expression116- Chromatin loop integration117118## Integration with Spatial Transcriptomics119120```121Spatial ATAC-seq Spatial RNA-seq122 | |123 v v124 Peak Matrix Expression Matrix125 | |126 +--------> Integration <-+127 |128 v129 Regulatory Network130 (Enhancer -> TF -> Gene)131```132133## Key Metrics134135| Metric | Description | Typical Range |136|--------|-------------|---------------|137| TSS Enrichment | Signal at transcription start sites | >4 good quality |138| FRiP | Fraction reads in peaks | >30% |139| Spatial autocorrelation | Moran's I for epigenetic features | 0.2-0.8 |140| Spots per gene | Detection sensitivity | 100-500 |141142## Prerequisites143144* Python 3.10+145* SnapATAC2, ArchR for ATAC analysis146* Squidpy, Scanpy for spatial analysis147* MACS2/Genrich for peak calling148149## Related Skills150151* Spatial_Transcriptomics - For gene expression spatial mapping152* Epigenomics_MethylGPT_Agent - For methylation analysis153* Single_Cell - For non-spatial epigenomics154155## Applications1561571. **Tumor Microenvironment**: Map regulatory programs across tumor-stroma boundary1582. **Development**: Track enhancer activation during tissue morphogenesis1593. **Neuroanatomy**: Brain region-specific regulatory landscapes1604. **Disease Mechanisms**: Spatial dysregulation in pathology161162## Author163164AI Group - Biomedical AI Platform165166167<!-- AUTHOR_SIGNATURE: 9a7f3c2e-MD-BABU-MIA-2026-MSSM-SECURE -->