bulkrna-deconvolution

bulkrna-deconvolution is a skill for Claude Code, Codex from TianGzlab/OmicsClaw. It costs 54 tokens per session (714 once invoked), scanned A, original, Apache-2.0.

A method for estimating the proportions of cell types in bulk RNA-sequencing samples. Bulk sequencing mixes signals from many cells, so it needs a reference profile or signature matrix for comparison.

In plain words
What is it for?
Use it with a bulk count matrix and a single-cell or signature-matrix reference to estimate per-sample cell-type proportions and produce tables, heatmaps, stacked charts, and a report.
Why use it?
It helps separate changes caused by different cell mixtures from changes within the cells themselves.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it with a bulk count matrix and a single-cell or signature-matrix reference to estimate per-sample cell-type proportions and produce tables, heatmaps, stacked charts, and a report.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/tiangzlab/omicsclaw/bulkrna-deconvolution
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add TianGzlab/OmicsClaw --skill bulkrna-deconvolution
Clone the repo
git clone --depth 1 https://github.com/TianGzlab/OmicsClaw

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for bulkrna-deconvolution

README.md
[![agentmods](https://agentmods.dev/badge/skills/tiangzlab/omicsclaw/bulkrna-deconvolution/github.svg)](https://agentmods.dev/skills/tiangzlab/omicsclaw/bulkrna-deconvolution)
Your own site
<a href="https://agentmods.dev/skills/tiangzlab/omicsclaw/bulkrna-deconvolution"><img src="https://agentmods.dev/badge/skills/tiangzlab/omicsclaw/bulkrna-deconvolution/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for bulkrna-deconvolution

Your own site · 80×15
<a href="https://agentmods.dev/skills/tiangzlab/omicsclaw/bulkrna-deconvolution"><img src="https://agentmods.dev/badge/skills/tiangzlab/omicsclaw/bulkrna-deconvolution.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 54 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 714 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to high

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • high Rogue Agent · line 3
    Skill modifies its own code, configuration, or behavior at runtime. Self-modification enables an agent to escalate privileges, disable safety constraints, or install persistent backdoors.
    Fix: Prevent the skill from modifying its own code, SKILL.md, or configuration files. Treat skill files as read-only at runtime.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00054 $0.00714
Opus 5.5 $0.00022 $0.00286
Sonnet 5.5 $0.00011 $0.00143
Haiku 4.5 $0.00005 $0.00071

Measured 15d ago against content hash 84caac25b4fb, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

bulkrna-deconvolution scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 15d ago.

The scan reads SKILL.md. This mod also ships 6 executable files (_api.py, bulkrna_deconvolution.py, examples/example_step.py, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/bulkrna/bulkrna-deconvolution/SKILL.md · 104 lines

How it starts

The opening of the file, as written. The whole thing — 104 lines — stays where its author put it; the contents beside it link to each section on GitHub.

bulkrna-deconvolution

When to use

Estimate bulk cell-type proportions with an explicit signature matrix. See the description for adjacent skills.

Use from a step

from skills._sdk.notebook import load_skill, read_input, write_output
library = load_skill("bulkrna-deconvolution")
# Supply DataFrames read with read_input(..., reader=...) for your CSV layout.
result = library.deconvolve(counts, signature=signature)
write_output(result, "tables/result.csv")

The synthetic worked step is in examples/example_step.py.

API

deconvolve(counts, *, signature)

Estimate sample proportions without changing either input.

:param counts: Nonnegative gene-by-sample expression DataFrame. :param signature: Required gene-by-cell-type reference, matching the CLI --reference. :returns: Sample-by-cell-type DataFrame; diagnostics contain residuals and shared genes. :raises ValueError: Matrices have invalid values, duplicate labels or no shared genes.

run_info(result, *, keep=True)

Read reference overlap and reconstruction diagnostics.

:param result: DataFrame returned by deconvolve. :param keep: Default True; False removes diagnostics from attrs. :returns: Diagnostic dictionary, empty after removal.

proportions_figure(result)

Plot estimated cell-type proportions per sample.

:param result: Sample-by-cell-type DataFrame from deconvolve. :returns: A matplotlib Figure, without writing files. :raises ValueError: The table cannot be plotted as numeric proportions.

Methods and parameters

See parameters and methodology.

Gotchas

  • deconvolve requires shared gene identifiers and nonnegative matrices.
  • run_info()['residuals'] measures fit to the supplied reference, not confidence intervals.
  • NNLS is the only backend; deconvolve does not call CIBERSORTx or MuSiC.

Inputs and outputs

Read the full file on GitHub · 104 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 15d ago Changed · +24 lines 84caac25b4fb
  2. 1mo ago First seen · 80 lines · 54 tokens per session scan A c3062fce2ed0

Subscribe to this mod's changes

bulkrna-deconvolution is a skill published in the GitHub repository TianGzlab/OmicsClaw (161 stars, last pushed 15d ago), licensed Apache-2.0. It adds 54 tokens to every session and 714 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

scanpy

Standard single-cell RNA-seq analysis pipeline. Use for QC, normalization, dimensionality reduction (PCA/UMAP/t-SNE), clustering, differential expression, and visualization. Best for exploratory scRNA-seq analysis with established workflows. For deep learning models use scvi-tools; for data format questions use…

synthetic-sciences/openscience · 68 tokens

cellxgene-census-query

Query CZ CELLxGENE Census (61M+ cells). Filter by cell type/tissue/disease, retrieve expression data, and integrate with scanpy/PyTorch for population-scale single-cell analysis. Use this skill when: (1) Querying single-cell expression data by cell type, tissue, or disease, (2) Exploring available single-cell datasets…

PharMolix/OpenBioMed · 105 tokens

single-cell-scrna-seq-analysis-scanpy

Complete single-cell RNA-seq analysis workflow built on Scanpy and AnnData. Use this skill when: (1) Loading diverse single-cell data formats (10X, h5ad, CSV), (2) Performing quality control and filtering, (3) Normalization, dimensionality reduction, and clustering, (4) Marker gene identification and cell type…

PharMolix/OpenBioMed · 85 tokens

single-cell-multi-omics-analysis-scvi

Probabilistic deep learning framework for single-cell multi-omics data analysis. Use this skill when: (1) Analyzing single-cell RNA-seq data with batch correction, (2) Integrating multi-modal data (CITE-seq, ATAC-seq, multi-omics), (3) Performing cell type annotation with scANVI, (4) Spatial transcriptomics…

PharMolix/OpenBioMed · 94 tokens

single-cell

Single-cell analysis pipeline covering scRNA-seq, snRNA-seq, and CyTOF (mass cytometry) — QC, normalization, integration, clustering, annotation, differential expression, trajectory, cell communication, and TF activity inference.

inflexa-ai/inflexa · 50 tokens

anndata

Data structure for annotated matrices in single-cell analysis. Use when working with .h5ad files or integrating with the scverse ecosystem. This is the data format skill—for analysis workflows use scanpy; for probabilistic models use scvi-tools; for population-scale queries use cellxgene-census.

synthetic-sciences/openscience · 63 tokens