sc-gene-programs

sc-gene-programs is a skill for Claude Code, Codex from TianGzlab/OmicsClaw. It costs 62 tokens per session (1,618 once invoked), scanned A, original, Apache-2.0.

A single-cell RNA sequencing analysis that groups genes into recurring expression programs and scores how strongly each cell uses each program. It works from an AnnData file, a common format for storing annotated single-cell data.

In plain words
What is it for?
Use it to discover latent gene programs, rank the genes in each program, and create per-cell program usage tables and plots.
Why use it?
It helps reveal coordinated biological patterns that may be missed when looking at genes one at a time.

Skill for Claude CodeCodex

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

Good fit Use it to discover latent gene programs, rank the genes in each program, and create per-cell program usage tables and plots.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/tiangzlab/omicsclaw/sc-gene-programs
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 sc-gene-programs
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 sc-gene-programs

README.md
[![agentmods](https://agentmods.dev/badge/skills/tiangzlab/omicsclaw/sc-gene-programs/github.svg)](https://agentmods.dev/skills/tiangzlab/omicsclaw/sc-gene-programs)
Your own site
<a href="https://agentmods.dev/skills/tiangzlab/omicsclaw/sc-gene-programs"><img src="https://agentmods.dev/badge/skills/tiangzlab/omicsclaw/sc-gene-programs/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 sc-gene-programs

Your own site · 80×15
<a href="https://agentmods.dev/skills/tiangzlab/omicsclaw/sc-gene-programs"><img src="https://agentmods.dev/badge/skills/tiangzlab/omicsclaw/sc-gene-programs.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 62 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,618 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.00062 $0.01618
Opus 5 $0.00031 $0.00809
Sonnet 5 $0.00012 $0.00324
Haiku 4.5 $0.00006 $0.00162

Measured 5d ago against content hash e1055ed6c762, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

sc-gene-programs 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 5d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (sc_gene_programs.py, tests/test_sc_gene_programs_methods.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/singlecell/scrna/sc-gene-programs/SKILL.md · 120 lines

How it starts

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

sc-gene-programs

When to use

The user has a non-negative scRNA AnnData (raw counts or log-normalised expression) and wants to decompose it into K gene programs (latent factors) plus a per-cell usage matrix. Two methods:

  • cnmf (default) — consensus NMF (multiple runs + clustering of factors) for stable programs. Auto-falls back to nmf if the cnmf package isn't installed.
  • nmf — sklearn NMF, single run.

Output: tables/program_usage.csv (cells × K), tables/program_weights.csv (genes × K), tables/top_program_genes.csv (top-N genes per program).

For per-cluster marker discovery use sc-markers; for TF → target regulons use sc-grn; for per-cell pathway scores against curated gene sets use sc-pathway-scoring.

Inputs & Outputs

Inputs

  • Modalities: scrna
  • File types: .h5ad
  • Requires a preprocessed AnnData (X normalised, PCA/neighbours present)

Outputs

  • tables/cell_metadata.csv
  • tables/gene_expression.csv
  • tables/program_correlation.csv
  • tables/program_tpm.csv
  • tables/program_usage.csv
  • tables/program_weights.csv
  • tables/top_program_genes.csv
  • figures/mean_program_usage.png
  • figures/program_correlation.png
  • figures/r_feature_cor.png
  • figures/r_feature_violin.png
  • analysis_summary.txt
  • processed.h5ad
  • report.md
  • result.json
  • Processed AnnData (saves_h5ad) — adds obsm: X_gene_programs

Flow

  1. Auto-fallback check: try import cnmf; if it fails, silently switch --method to nmf.
  2. Load AnnData (--input) or build a demo.
  3. Preflight: pick source matrix per --layer (auto-prefer layers["counts"] for cnmf when --layer is unset); reject negative values; warn if n_genes < 50 or running NMF on raw counts without --layer counts.
  4. Run cNMF (consensus NMF with --n-iter runs) or sklearn NMF (single run, --seed).
  5. Build top-genes-per-program table; compute per-program correlation matrix.
  6. Detect degenerate output → record diagnostics; do NOT raise.
  7. Save tables, figures, processed.h5ad, report.md, result.json.

Read the full file on GitHub · 120 lines

Files

What ships with it

7 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 5d ago First seen · 120 lines · 62 tokens per session scan A e1055ed6c762

Subscribe to this mod's changes

sc-gene-programs is a skill published in the GitHub repository TianGzlab/OmicsClaw (160 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 62 tokens to every session and 1,618 once invoked, about $0.0003 per session on Opus 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-09-03.

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

Virtual Embryo — atlas data + knowledge graph

Query the Virtual Embryo knowledge graph (mouse/human developmental biology: genes, anatomy, Theiler/Carnegie stages, gene expression, diseases, papers) and its 3D atlas catalog (anatomical OPT/light-sheet volumes + 3D spatial- transcriptomics datasets), and visualise those datasets in 3D with the volume3d / spatial3d…

aristoteleo/PantheonOS · 170 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 Analysis Skills Index

Core skills for single-cell RNA-seq analysis: quality control, cell type annotation, and trajectory inference. These are high-priority actionable workflows — load them first for common single-cell tasks.

aristoteleo/PantheonOS · 48 tokens