Agent skill

Spatial Transcriptomics

by QING1105 in QING1105/ezST

End-to-end 10x Visium spatial transcriptomics analysis workflow with staged execution and human review gates.

MITAuto-check passedResearch & Science

Install Spatial Transcriptomics

skills CLI
$ npx skills add QING1105/ezST --skill spatial-transcriptomics -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install QING1105/ezST spatial-transcriptomics --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/QING1105/ezST.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/spatial-transcriptomics/skills/spatial-transcriptomics .claude/skills/spatial-transcriptomics && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
spatial-transcriptomics
GitHub stars
101
Token cost
~1.4k tokens
SKILL.md length
566 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

End-to-end 10x Visium spatial transcriptomics analysis workflow with staged execution and human review gates.

  • Works in 4 steps: Run the tool chain for that stage,… → Interpret the outputs with the vision… → Stop and present the interpretation +… → …
  • The user asks to analyze Visium / spatial transcriptomics data
  • SKILL.md covers Overview, Environment Check (run first), Data Requirements and Stage Protocol, plus 3 more sections
  • Calls python and pip

What it does

Spatial Transcriptomics is an agent skill from QING1105/ezST. End-to-end 10x Visium spatial transcriptomics analysis workflow with staged execution and human review gates. Use when the user asks to analyze Visium / spatial transcriptomics data, run spatial analysis pipelines (load, QC, normalize, cluster, spatial domains, SVG, deconvolution, neighborhood enrichment, cell-cell communication), or interpret spatial plots biologically. Each stage produces plots and results, the LLM interprets their biological meaning, then stops and waits for the user's review before proceeding.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science, covering Bioinformatics and Human-in-the-loop approvals. It works with Python. The repository describes itself as: 10x Visium spatial transcriptomics analysis skills for Codex — staged workflow with human review gates and LLM biological interpretation. The licence is MIT.

When your agent uses it

  • The user asks to analyze Visium / spatial transcriptomics data
  • Run spatial analysis pipelines (load
  • Spatial domains
  • Neighborhood enrichment

Example prompts

  • “/spatial-transcriptomics”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Run the tool chain for that stage, producing plots (PNG) and result files.
  2. Interpret the outputs with the vision tool (for plots) and by reading result files. Write a biological interpretation using the template…
  3. Stop and present the interpretation + plots to the user.
  4. Wait for review. The user chooses one of: 通过 (proceed), 调整 (adjust parameters and rerun this stage), or 跳过 (skip this stage and continue).

What it can do on your machine

Read from SKILL.md and the folder at commit 429f9fc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Spatial Transcriptomics loads about 1.4k tokens when it runs. Until then it costs about 136 tokens; SKILL.md has 566 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~136
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from QING1105/ezST at commit 429f9fc, republished under its MIT licence (© QING1105). 566 words, ~1,422 tokens.

Download SKILL.mdSave it as .claude/skills/spatial-transcriptomics/SKILL.md (or your agent's skills folder).
name
spatial-transcriptomics
description
End-to-end 10x Visium spatial transcriptomics analysis workflow with staged execution and human review gates. Use when the user asks to analyze Visium / spatial transcriptomics data, run spatial analysis pipelines (load, QC, normalize, cluster, spatial domains, SVG, deconvolution, neighborhood enrichment, cell-cell communication), or interpret spatial plots biologically. Each stage produces plots and results, the LLM interprets their biological meaning, then stops and waits for the user's review before proceeding.
license
MIT

Spatial Transcriptomics (10x Visium) Staged Workflow

Overview

Run 10x Visium spatial transcriptomics analysis as a staged pipeline. The workflow is split into 5 stages. Each stage:

  1. Run the tool chain for that stage, producing plots (PNG) and result files.
  2. Interpret the outputs with the vision tool (for plots) and by reading result files. Write a biological interpretation using the template below.
  3. Stop and present the interpretation + plots to the user.
  4. Wait for review. The user chooses one of: 通过 (proceed), 调整 (adjust parameters and rerun this stage), or 跳过 (skip this stage and continue).

Do NOT proceed to the next stage without an explicit user decision.

Environment Check (run first)

Before any analysis, verify the environment is ready. If not, guide the user to install it (one command, no manual steps):

bash
# Check critical Python packages
python -c "import scanpy, squidpy, scvi, leidenalg; print('OK')"
# Check critical R packages (only needed for S4/S5)
Rscript -e "library(Seurat); library(SPOTlight); library(CellChat); cat('OK\n')"

If any Python import fails:

  1. Tell the user ezST is not installed.
  2. Install it with pip (one command, auto-installs all Python deps):
    bash
    pip install git+https://github.com/QING1105/ezST.git
  3. Re-run the Python check above.

If R packages are missing (only needed for S4 deconvolution / S5 communication):

  1. Tell the user the R deps are missing.
  2. Run the R installer (single command):
    bash
    Rscript install/install_r_packages.R
    (needs R >= 4.3; Windows needs Rtools)
  3. Re-run the R check above.

Do NOT start analysis until the required checks pass (S1-S3 only need Python; S4/S5 also need R).

Data Requirements

The workflow accepts three input formats (auto-detected):

FormatFilesNotes
h5adsingle .h5ad with obsm['spatial']Preferred; coordinates embedded
10x matrixmatrix.mtx.gz + barcodes.tsv.gz + features.tsv.gzStandard CellRanger output
wide CSVcounts CSV + spot coordinates CSVRows = barcodes, cols = genes

Reference scRNA-seq (h5ad with cell-type labels in obs) is required for deconvolution stages.

Stage Protocol

S1 — Load + QC
  • Tool chain: init_spatial_project → load_visium_data → filter_visium_spots
  • Plots: QC violin plots / spot count distributions before and after filtering
  • Results: filtered h5ad, QC summary
  • Review focus: are the filtering thresholds (min_counts, min_genes, pct_mt) reasonable? Is the retained spot count consistent with the expected tissue size?
Show full SKILL.md (245 more words)Show less
S2 — Normalize + Cluster
  • Tool chain: normalize_visium → cluster_spatial_data
  • Plots: UMAP, spatial scatter colored by cluster
  • Results: normalized/clustered h5ad
  • Review focus: is the number of clusters biologically plausible? Do clusters segregate spatially (not just noise)?
S3 — Spatial Domains + SVG
  • Tool chain: identify_spatial_domains → find_spatially_variable_genes
  • Plots: spatial domain map, top SVG spatial plots
  • Results: domain assignments, SVG ranked CSV
  • Review focus: do spatial domains match known tissue architecture (e.g., tumor regions, immune infiltrate)? Do top SVGs make biological sense for the tissue?
S4 — Deconvolution
  • Tool chain: deconvolve_spatial_destvi (preferred) or deconvolve_spatial_spotlight
  • Plots: cell-type proportion spatial maps, proportion stacked bar
  • Results: proportions CSV per spot, deconvolved h5ad
  • Review focus: are the dominant cell types consistent with the tissue type? Any unexpected cell type dominating?
S5 — Downstream (Neighborhood + Communication)
  • Tool chain: spatial_neighborhood_enrichment → infer_spatial_cell_communication
  • Plots: neighborhood enrichment heatmap, CellChat network/heatmap plots
  • Results: enrichment z-score table, CellChat object + summary
  • Review focus: are enriched co-localizations and inferred ligand-receptor interactions biologically plausible?

Biological Interpretation Template

Use this exact structure for every stage's interpretation:

【S{n} 阶段结果】
- 关键数字:XXX spots retained / XXX clusters / XXX spatial domains / top cell types...
- 图片观察:图中可见……(描述 spatial pattern, e.g., 高表达区域聚集在左上象限)
- 生物学意义:这提示……(e.g., 该区域可能是肿瘤浸润边缘,富集免疫细胞通讯)
- 建议:是否调整参数 / 进入下一阶段

Review Protocol

After presenting the interpretation, ask the user explicitly (do not assume):

  • 通过 → proceed to next stage
  • 调整 → ask which parameters to change, rerun only the current stage
  • 跳过 → skip current stage, continue to next

Record the user's decision for each stage in the final summary.

Output Conventions

  • All results under the project directory created by init_spatial_project (e.g., /data/gastric/proj/).
  • Naming: results/01_loading/, results/02_qc/, results/03_normalization/, results/04_clustering/, results/05_domains/, results/06_svg/, results/07_deconvolution/, results/08_neighborhood/, results/09_communication/.
  • Final summary at the end: one line per stage with user decision (通过/调整/跳过).

© QING1105, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/spatial-transcriptomics/skills/spatial-transcriptomics of QING1105/ezST.

Open the folder on GitHubat commit 429f9fc

Compare with similar skills

Spatial Transcriptomics next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Spatial Transcriptomics compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spatial Transcriptomics this skillQING1105/ezST101—~1.4kAutomated safety check: PassMIT
Singlecell Qcxuzhougeng/wisp-science1k—~1.6kAutomated safety check: PassAGPL-3.0
Alphagenome Single Variant Analysisgoogle-deepmind/science-skills3.2k2 repos~3kAutomated safety check: NotesApache-2.0
13C Metabolic Flux AnalysisK-Dense-AI/scientific-agent-skills48k1 repos~3.2kAutomated safety check: PassMIT
Trackplotygidtu/trackplot109—~1.9kAutomated safety check: PassBSD-3-Clause
UniProt Database Accessdavila7/claude-code-templates32k15 repos~1.7kAutomated safety check: PassMIT

Similar skills

  • Singlecell Qc

    xuzhougeng/wisp-science

    A skill your agent uses when designing, reviewing, or implementing single-cell RNA-seq QC in Python or R with a human-in-the-loop, data-driven approach.

    1k GitHub stars~1.6k tokensUpdated today
    Research & ScienceAuto-check passed
  • Alphagenome Single Variant Analysis

    google-deepmind/science-skills

    Analyzes genetic variant effects on gene expression (RNA-seq), chromatin accessibility (DNASE), histone marks (ChIP), and transcription factors using the AlphaGenome API.

    3.2k GitHub starsUsed in 2 repos~3k tokens
    Research & ScienceAuto-check: notes
  • 13C Metabolic Flux Analysis

    K-Dense-AI/scientific-agent-skills

    Estimates reaction fluxes inside cells from steady-state carbon-13 labeling data with a bundled mfapy-based solver, and reports which fluxes the data pin down.

    48k GitHub starsUsed in 1 repo~3.2k tokens
    Research & ScienceAuto-check passed
  • Trackplot

    ygidtu/trackplot

    Generate sashimi-style genome visualization plots (coverage, line, heatmap, IGV read-by-read, HiC, circRNA, motif) from BAM/bigWig/depth/HiC inputs.

    109 GitHub stars~1.9k tokensUpdated 11 days ago
    Research & ScienceAuto-check passed
  • UniProt Database Access

    davila7/claude-code-templates

    Queries the UniProt REST API directly to search proteins, fetch FASTA sequences, map IDs between databases and read Swiss-Prot and TrEMBL entries.

    32k GitHub starsUsed in 15 repos~1.7k tokens
    Research & ScienceAuto-check passed
  • deepTools NGS Toolkit

    davila7/claude-code-templates

    Guides use of deepTools on sequencing data: BAM to bigWig conversion, QC, sample correlation, and heatmaps or profiles around TSS and peaks for ChIP-seq, RNA-seq and ATAC-seq.

    32k GitHub starsUsed in 13 repos~4.5k tokens
    Research & ScienceAuto-check passed

More from QING1105/ezST

All 11 skills in this repo
  • Spatial Visium Hd

    QING1105/ezST

    Visium HD platform branch of the spatial transcriptomics workflow — reconstruct single cells from 2 μm bins via morphological segmentation and bin-to-cell aggregation.

    101 GitHub stars~2.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Spatial Atera

    QING1105/ezST

    Atera platform branch of the spatial transcriptomics workflow — load and validate Atera cell-level output (AnnData + Zarr segmentation) for downstream analysis.

    101 GitHub stars~576 tokensUpdated 1 mo ago
    Auto-check passed
  • Stage 3 of the spatial transcriptomics workflow — identify spatial domains and detect spatially variable genes.

    101 GitHub stars~476 tokensUpdated 1 mo ago
    Auto-check passed
  • Stage 4 of the spatial transcriptomics workflow — deconvolve Visium spots into cell-type proportions.

    101 GitHub stars~480 tokensUpdated 1 mo ago
    Auto-check passed
  • Stage 5 of the spatial transcriptomics workflow — neighborhood enrichment and cell-cell communication analysis.

    101 GitHub stars~513 tokensUpdated 1 mo ago
    Auto-check passed
  • Spatial Visium

    QING1105/ezST

    Classic Visium platform branch of the spatial transcriptomics workflow — spot-level 5-stage pipeline (load+QC, normalize+cluster, domains+SVG, deconvolution, downstream prep).

    101 GitHub stars~750 tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Spatial Transcriptomics

What does Spatial Transcriptomics do?

End-to-end 10x Visium spatial transcriptomics analysis workflow with staged execution and human review gates. Spatial Transcriptomics is an agent skill from QING1105/ezST. End-to-end 10x Visium spatial transcriptomics analysis workflow with staged execution and human review gates.

When should I use Spatial Transcriptomics?

Spatial Transcriptomics fits situations like: the user asks to analyze Visium / spatial transcriptomics data; run spatial analysis pipelines (load; spatial domains; neighborhood enrichment.

How do I install Spatial Transcriptomics in Claude Code?

Run `npx skills add QING1105/ezST --skill spatial-transcriptomics -a claude-code`. Or copy the skill folder (plugins/spatial-transcriptomics/skills/spatial-transcriptomics in QING1105/ezST) into .claude/skills/spatial-transcriptomics in your project. Claude Code loads it when a task matches its description.

How do I install Spatial Transcriptomics in Codex?

Run `npx skills add QING1105/ezST --skill spatial-transcriptomics -a codex`. Or copy the skill folder (plugins/spatial-transcriptomics/skills/spatial-transcriptomics in QING1105/ezST) into .agents/skills/spatial-transcriptomics in your project. Codex loads it when a task matches its description.

Can I use Spatial Transcriptomics in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add QING1105/ezST --skill spatial-transcriptomics -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spatial-transcriptomics, .gemini/skills/spatial-transcriptomics, .github/skills/spatial-transcriptomics and .opencode/skills/spatial-transcriptomics in your project.

What does Spatial Transcriptomics need to run?

Going by SKILL.md and its folder, Spatial Transcriptomics needs the command-line tools its instructions call (python and pip). Our summary lists: Python 3.

Does Spatial Transcriptomics access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Spatial Transcriptomics safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Spatial Transcriptomics use?

Spatial Transcriptomics is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Spatial Transcriptomics use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Spatial Transcriptomics?

Skills that share tags, products or a category with Spatial Transcriptomics: Singlecell Qc (xuzhougeng/wisp-science, 1k stars), Alphagenome Single Variant Analysis (google-deepmind/science-skills, 3.2k stars), 13C Metabolic Flux Analysis (K-Dense-AI/scientific-agent-skills, 48k stars) and Trackplot (ygidtu/trackplot, 109 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spatial Transcriptomics?

QING1105 (a GitHub user) maintains it in QING1105/ezST, which has 101 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on August 26, 2026.

Source: QING1105/ezST on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.