sample2barcode-generation

Generate Sample2Barcode CSV files for CellRanger multi demultiplexing on FGCZ SUSHI infrastructure.

Updated May 28, 2026
One-click install
npx skills add https://github.com/cpanse/skills --skill sample2barcode-generation-cpanse
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sample2barcode-generation
Source: https://github.com/cpanse/skills/tree/main/sequencing-pipelines/skills/sample2barcode-generation
Command: npx skills add https://github.com/cpanse/skills --skill sample2barcode-generation-cpanse

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? Setting up CellRanger multi demultiplexing requires precisely formatted Sample2Barcode CSV files whose column names, quoting conventions, and reference files differ across OCM, HTO/CMO, and Flex v2 multiplexing methods. This Skill eliminates misconfiguration errors by generating the exact FGCZ/SUSHI-specific file formats and parameters for each multiplexing chemistry. ## Core Features & Use Cases - OCM demultiplexing files: Create unquoted CSVs with ocm_barcode_ids columns for On-Chip Multiplexing with OB1-OB4 barcodes (4-plex max, CellRanger 9.0+). - HTO/CMO demultiplexing files: Create quoted CSVs with cmo_ids columns for TotalSeq-B/C hashtag antibodies, including pipe-separated double-hashing support. - Flex v2 probe barcode files: Create CSVs with probe_barcode_ids and description columns for Fixed RNA Panel v2 multiplexing from 4-plex to 384-plex (CellRanger 10.0+). - SUSHI integration guidance: Provides required CellRangerMulti app parameters, MultiplexBarcodeSet reference file selection, gstore folder placement, and troubleshooting for common ezRun errors. - Use Case: A lab delivers 8 pooled samples labeled with TotalSeq-B hashtags B0303-B0305. Use this Skill to generate one {PoolName}_Sample2Barcode.csv per pool, copy them to /srv/gstore/projects/pXXXXX/oXXXXX_metaData/, and configure SUSHI with MultiplexingType = antibody. ## Quick Start Ask the agent to generate a Sample2Barcode file for your pool by providing the sample names and their hashtag, OCM, or Flex v2 probe barcode assignments.

Frequently Asked Questions about sample2barcode-generation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Sample2Barcode file for CellRanger multi demultiplexing?

Create one CSV per pool named {PoolName}_Sample2Barcode.csv with sample-to-barcode mappings, then place it in /srv/gstore/projects/pXXXXX/oXXXXX_metaData/. The column names and quoting depend on the multiplexing type: cmo_ids quoted for HTO, ocm_barcode_ids unquoted for OCM, probe_barcode_ids unquoted for Flex v2.

What is the difference between OCM, HTO, and Flex v2 multiplexing formats?

OCM uses unquoted ocm_barcode_ids with OB1-OB4 barcodes and needs no reference file. HTO/CMO uses quoted cmo_ids matching TotalSeq-B/C reference files. Flex v2 uses unquoted probe_barcode_ids like A-A01 plus a description column, and requires CellRanger 10.0+.

Which MultiplexBarcodeSet reference file should I use in SUSHI?

Use 10x_BL_TotalSeqB_20230620_v1_AntibodyCapture.csv for mouse TotalSeq-B, 10x_BL_TotalSeqC_20230620_v1_AntibodyCapture.csv for human TotalSeq-C, or 10x_CMO_20230620_v1.csv for 10x CMO lipid multiplexing. Leave it empty for OCM and Flex v2 workflows.

Does CellRanger support double-hashing with multiple hashtags per sample?

Yes, double-hashing is supported for HTO by listing pipe-separated barcode IDs in the cmo_ids column, such as "B0301|B0304" with no spaces. This requires ezRun commit fef7f98c or later to parse the pipe-separated values correctly.

Why does SUSHI fail with 'cannot open file CMO_files: it is a directory'?

This error occurs when the MultiplexBarcodeSet parameter is left empty for an HTO/CMO run. Set it to the appropriate _AntibodyCapture.csv reference file, such as 10x_BL_TotalSeqB_20230620_v1_AntibodyCapture.csv for mouse samples.

What CellRanger version is required for Flex v2 probe multiplexing?

Flex v2 Fixed RNA Panel multiplexing requires CellRanger 10.0.0 or later; earlier versions fail chemistry detection. Load it with module load Aligner/CellRanger/10.0.0 and do not set FeatureBarcodeFile or MultiplexBarcodeSet, which are HTO-only parameters.