sc-perturb-prep

sc-perturb-prep is a skill for Claude Code, Codex from TianGzlab/OmicsClaw. It costs 85 tokens per session (1,759 once invoked), scanned A, original, Apache-2.0.

A tool that attaches guide assignments from a mapping table to Perturb-seq expression data. Perturb-seq combines genetic perturbations with single-cell RNA measurements.

In plain words
What is it for?
Merging barcode-to-sgRNA mappings with expression data and recording single-guide, multi-guide, and unassigned cells.
Why use it?
It connects each cell to its guide, target gene, and assignment status before perturbation-response analysis.

Skill for Claude CodeCodex

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

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.

agentmods
npx agentmods add skills/tiangzlab/omicsclaw/sc-perturb-prep
Any agent
npx skills add TianGzlab/OmicsClaw --skill sc-perturb-prep
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-perturb-prep

README.md
[![agentmods](https://agentmods.dev/badge/skills/tiangzlab/omicsclaw/sc-perturb-prep.svg)](https://agentmods.dev/skills/tiangzlab/omicsclaw/sc-perturb-prep)
Your own site
<a href="https://agentmods.dev/skills/tiangzlab/omicsclaw/sc-perturb-prep"><img src="https://agentmods.dev/badge/skills/tiangzlab/omicsclaw/sc-perturb-prep.svg" alt="Measured on agentmods" height="20"></a>
Per session 85 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,759 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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.00085 $0.01759
Opus 5 $0.00043 $0.00879
Sonnet 5 $0.00017 $0.00352
Haiku 4.5 $0.00009 $0.00176

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

Security

Grade A, and why

sc-perturb-prep 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 2d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (sc_perturb_prep.py, tests/test_sc_perturb_prep_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-perturb-prep/SKILL.md · 124 lines

How it starts

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

sc-perturb-prep

When to use

The user has Perturb-seq expression data (10x h5 / matrix dir / h5ad) and an upstream barcode-to-sgRNA mapping table (TSV / CSV from demultiplex / cellranger / cellbender output) and needs them merged into a single AnnData with:

  • obs[--pert-key] (default perturbation) — canonical perturbation label
  • obs[--sgrna-key] (default sgRNA) — guide identifier
  • obs[--target-key] (default target_gene) — inferred target gene
  • obs["assignment_status"]single_guide / multi_guide / unassigned
  • obs["n_sgrnas"] — count per cell

Single backend: mapping_tsv. Then chain to sc-perturb for Mixscape classification. This skill does NOT infer guide identities from FASTQ — bring an upstream assignment table.

Inputs & Outputs

Inputs

  • Input kinds: file, directory
  • Modalities: scrna
  • File types: .h5ad, .h5, .loom, .tsv, .csv

Outputs

  • tables/assignment_status_counts.csv
  • tables/cell_metadata.csv
  • tables/dropped_multi_guide_cells.csv
  • tables/feature_type_summary.csv
  • tables/perturbation_assignments.csv
  • tables/perturbation_counts.csv
  • figures/perturbation_counts.png
  • analysis_summary.txt
  • processed.h5ad
  • report.md
  • result.json
  • Processed AnnData (saves_h5ad) — adds obs: perturbation, sgRNA, target_gene, assignment_status, n_sgrnas

Flow

  1. Load expression input via smart_load; load mapping via load_sgrna_mapping (auto-detect --sep if unset).
  2. Strip non-gene features from var (e.g., 10x guide / antibody capture rows).
  3. Collapse mapping rows per cell: tag single_guide / multi_guide / unassigned based on row count.
  4. Drop multi_guide cells unless --keep-multi-guide is set.
  5. Match each sgRNA against --control-patterns (,-separated, includes default NT-style patterns); rewrite matches to --control-label (default NT).
  6. Infer target gene from sgRNA ID via --delimiter + --gene-position, OR use --target-column from the mapping if provided.
  7. Save standardised AnnData, tables, figure, report.md, result.json.

Read the full file on GitHub · 124 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. 2d ago First seen · 124 lines · 85 tokens per session scan A a7a44880d343

Subscribe to this mod's changes

sc-perturb-prep is a skill published in the GitHub repository TianGzlab/OmicsClaw (160 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 85 tokens to every session and 1,759 once invoked, about $0.0004 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 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

motif-for-claude-science-skill

Prepares, shares, inspects, or explains the standalone Motif for Claude Science artifact, including sequence inventories, alignments, traces, and browser review.

jvogan/motif · 43 tokens

motif

Use Motif to create and open interactive molecular-biology workbenches for DNA, RNA, and protein records, annotations, alignments, traces, results, and construct designs.

jvogan/motif · 39 tokens