Agent skill

Spatial S4 Deconvolve

by QING1105 in QING1105/ezST

Stage 4 of the spatial transcriptomics workflow — deconvolve Visium spots into cell-type proportions.

MITAuto-check passedResearch & Science

Install Spatial S4 Deconvolve

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

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

GitHub CLI
$ gh skill install QING1105/ezST spatial-s4-deconvolve --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/s4-deconvolve .claude/skills/spatial-s4-deconvolve && 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-s4-deconvolve
GitHub stars
101
Token cost
~480 tokens
SKILL.md length
158 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Stage 4 of the spatial transcriptomics workflow — deconvolve Visium spots into cell-type proportions.

  • Works in 2 steps: DestVI (preferred):… → SPOTlight (alternative):…
  • The user asks to deconvolve spatial spots
  • SKILL.md covers Goal, Prerequisites, Steps and Outputs, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Spatial S4 Deconvolve is an agent skill from QING1105/ezST. Stage 4 of the spatial transcriptomics workflow — deconvolve Visium spots into cell-type proportions. Use when the user asks to deconvolve spatial spots, estimate cell-type composition, or run DestVI / SPOTlight with a scRNA-seq reference. Produces cell-type proportion maps, then stops for review.

Its SKILL.md is about 480 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. 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 deconvolve spatial spots
  • Estimate cell-type composition
  • Run DestVI / SPOTlight with a scRNA-seq reference

Example prompts

  • “/spatial-s4-deconvolve”

Workflow steps

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

  1. DestVI (preferred): deconvolve_spatial_destvi(ref_h5ad=..., st_h5ad=..., cell_type_key=..., output_dir=..., plot_path=..., n_latent=…
  2. SPOTlight (alternative): deconvolve_spatial_spotlight(ref_h5ad=..., st_h5ad=..., cell_type_key=..., output_dir=..., plot_path=…

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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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 S4 Deconvolve loads about 480 tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 158 words of instructions outside code blocks.

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

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). 158 words, ~480 tokens.

Download SKILL.mdSave it as .claude/skills/spatial-s4-deconvolve/SKILL.md (or your agent's skills folder).
name
spatial-s4-deconvolve
description
Stage 4 of the spatial transcriptomics workflow — deconvolve Visium spots into cell-type proportions. Use when the user asks to deconvolve spatial spots, estimate cell-type composition, or run DestVI / SPOTlight with a scRNA-seq reference. Produces cell-type proportion maps, then stops for review.
license
MIT

S4 — Deconvolution

Goal

Estimate cell-type proportions for each Visium spot using a reference scRNA-seq dataset with cell-type labels.

Prerequisites

  • Reference scRNA-seq h5ad with cell-type labels in obs (e.g., column level_3).
  • Clustered Visium h5ad from S2 (or raw loaded h5ad — DestVI works on raw counts).

Steps

  1. DestVI (preferred): deconvolve_spatial_destvi(ref_h5ad=..., st_h5ad=..., cell_type_key=..., output_dir=..., plot_path=..., n_latent=..., max_epochs=..., destvi_max_epochs=...)
    • Defaults: n_latent=30, max_epochs=400 (CondSCVI), destvi_max_epochs=500.
    • Requires scvi-tools installed.
  2. SPOTlight (alternative): deconvolve_spatial_spotlight(ref_h5ad=..., st_h5ad=..., cell_type_key=..., output_dir=..., plot_path=..., r_script_path=...)
    • Requires R + SPOTlight package (see install_r_packages_spatial.R).

Outputs

  • results/07_deconvolution/<sample>_proportions.csv (spots × cell types)
  • results/07_deconvolution/<sample>_proportions_*.png (spatial proportion maps, stacked bar)

Biological Interpretation

  • Report dominant cell types and their spatial localization.
  • Cross-check with tissue type: e.g., gastric cancer should show epithelial/tumor cells in tumor regions, immune cells at infiltrate margins.
  • Flag any surprising dominant cell type (e.g., >50% of a cell type not expected in the tissue).

Stop for Review

Present interpretation using the template from the parent spatial-transcriptomics skill. Wait for 通过 / 调整 / 跳过 before proceeding to S5.

© 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/s4-deconvolve of QING1105/ezST.

Open the folder on GitHubat commit 429f9fc

Compare with similar skills

Spatial S4 Deconvolve 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 S4 Deconvolve compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spatial S4 Deconvolve this skillQING1105/ezST101—~480Automated safety check: PassMIT
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
Clinvar Databasegoogle-deepmind/science-skills3.2k2 repos~3.9kAutomated safety check: NotesApache-2.0
Metabolic Study Planneraiming-lab/AutoResearchClaw15k—~1.9kAutomated safety check: PassMIT
Dbsnp Databasegoogle-deepmind/science-skills3.2k2 repos~3.4kAutomated safety check: NotesApache-2.0

Similar skills

  • 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
  • Clinvar Database

    google-deepmind/science-skills

    A skill your agent uses when needing clinical significance, pathogenicity classifications (e.g., Pathogenic, Benign, VUS), clinical evidence rationales, or finding "hard positive" benchmark controls…

    3.2k GitHub starsUsed in 2 repos~3.9k tokens
    Research & ScienceAuto-check: notes
  • Metabolic Study Planner

    aiming-lab/AutoResearchClaw

    Turns a broad metabolic modelling topic into a concrete, paper-shaped plan with organism, model, perturbations, metrics and figures before any FBA code is written.

    15k GitHub stars~1.9k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Dbsnp Database

    google-deepmind/science-skills

    A skill your agent uses when you want to look up, map, and search for short genetic variants (SNPs, indels) in NCBI's dbSNP database.

    3.2k GitHub starsUsed in 2 repos~3.4k tokens
    Research & ScienceAuto-check: notes
  • MFA Pipeline Orchestrator

    aiming-lab/AutoResearchClaw

    Runs a metabolic flux analysis from model loading to phenotype prediction and figures by handing work to four sub-agents in sequence.

    15k GitHub stars~923 tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed

More from QING1105/ezST

All 11 skills in this repo
  • End-to-end 10x Visium spatial transcriptomics analysis workflow with staged execution and human review gates.

    101 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check passed
  • 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 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

Questions about Spatial S4 Deconvolve

What does Spatial S4 Deconvolve do?

Stage 4 of the spatial transcriptomics workflow — deconvolve Visium spots into cell-type proportions. Spatial S4 Deconvolve is an agent skill from QING1105/ezST. Stage 4 of the spatial transcriptomics workflow — deconvolve Visium spots into cell-type proportions.

When should I use Spatial S4 Deconvolve?

Spatial S4 Deconvolve fits situations like: the user asks to deconvolve spatial spots; estimate cell-type composition; run DestVI / SPOTlight with a scRNA-seq reference.

How do I install Spatial S4 Deconvolve in Claude Code?

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

How do I install Spatial S4 Deconvolve in Codex?

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

Can I use Spatial S4 Deconvolve 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-s4-deconvolve -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-s4-deconvolve, .gemini/skills/spatial-s4-deconvolve, .github/skills/spatial-s4-deconvolve and .opencode/skills/spatial-s4-deconvolve in your project.

What does Spatial S4 Deconvolve need to run?

SKILL.md names no scripts, command-line tools or credentials: Spatial S4 Deconvolve is instructions for the agent only.

Does Spatial S4 Deconvolve access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Spatial S4 Deconvolve 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 S4 Deconvolve use?

Spatial S4 Deconvolve 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 S4 Deconvolve use?

About 480 tokens (SKILL.md is roughly 1.9k 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 S4 Deconvolve?

Skills that share tags, products or a category with Spatial S4 Deconvolve: Alphagenome Single Variant Analysis (google-deepmind/science-skills, 3.2k stars), 13C Metabolic Flux Analysis (K-Dense-AI/scientific-agent-skills, 48k stars), Clinvar Database (google-deepmind/science-skills, 3.2k stars) and Metabolic Study Planner (aiming-lab/AutoResearchClaw, 15k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spatial S4 Deconvolve?

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.