bio-experimental-design-batch-design

SkillMedia

This skill helps your AI design experiments so technical variation does not mask real biological signals. It uses balanced layouts and blocking strategies to minimize and account for batch effects, which matters when planning multi-batch studies or assigning samples to sequencing lanes.

Available today. Use it from your connected AI after setup.

Add the skill, then describe your planned experiment — including samples, batches, and sequencing setup — and ask your AI to propose a balanced design.

Then ask your AI: use the bio-experimental-design-batch-design skill

What your AI can do with it

  • Plan multi-batch experiments with balanced layouts
  • Assign samples to sequencing lanes
  • Apply blocking strategies to minimize batch effects
  • Design studies where technical variation could confound biological signals
  • Account for batch effects when structuring an experiment

What this skill tells your AI

The instructions your AI receives, as published by biotender-max/awesome-bio-agent-skills in skills/bioskills/batch-design/SKILL.md and read by ahel’s review.

Version Compatibility

Reference examples tested with: limma 3.58+

Before using code patterns, verify installed versions match. If versions differ:

  • R: packageVersion('<pkg>') then ?function_name to verify parameters

If code throws ImportError, AttributeError, or TypeError, introspect the installed package and adapt the example to match the actual API rather than retrying.

Batch Design and Mitigation

"Design experiment to avoid batch effects" → Plan sample-to-batch assignments that confound biology with technical variation, and apply correction methods post-hoc.

  • R: sva::ComBat(), limma::removeBatchEffect()
  • Python: scanpy.pp.combat() for single-cell data

Core Principle

Batch effects are unavoidable. Good design makes them correctable.

Design Rules

  1. Never confound batch with condition - Each batch must contain all conditions
  2. Balance samples across batches - Equal numbers per condition per batch
  3. Randomize within constraints - Avoid systematic patterns
  4. Include controls - Same samples across batches if possible

Balanced Design Example

# BAD: Confounded design
# Batch 1: All treated samples
# Batch 2: All control samples
# -> Cannot separate batch from treatment

# GOOD: Balanced design
# Batch 1: 3 treated, 3 control
# Batch 2: 3 treated, 3 control
# -> Batch effect can be estimated and removed

Sample Assignment

library(designit)

# Create balanced assignment
samples <- data.frame(
  sample_id = paste0('S', 1:24),
  condition = rep(c('ctrl', 'treat'), each = 12),
  sex = rep(c('M', 'F'), 12)
)

# Optimize batch assignment
batch_design <- osat(samples, batch_size = 8,
                     balance_cols = c('condition', 'sex'))

Detecting Batch Effects

Goal: Identify hidden batch effects in expression data by estimating surrogate variables that capture unmodeled technical variation.

Approach: Fit a model matrix for the biological variable, estimate the number of surrogate variables using num.sv, then compute surrogate variables with sva for inclusion in downstream differential analysis.

library(sva)

# From count matrix
mod <- model.matrix(~condition, colData)
mod0 <- model.matrix(~1, colData)

# Estimate number of surrogate variables (hidden batches)
n_sv <- num.sv(counts_normalized, mod)

# Estimate surrogate variables
svobj <- sva(counts_normalized, mod, mod0, n.sv = n_sv)

Correction Methods

MethodWhen to Use
ComBatKnown batches, moderate effects
SVAUnknown batches, exploratory
RUVseqUsing control genes
limma::removeBatchEffectVisualization only

Documenting Design

Always record:

  • Date of sample processing
  • Reagent lot numbers
  • Operator
  • Equipment/lane assignments
  • Any deviations from protocol

Related Skills

  • experimental-design/power-analysis - Account for batch in power calculations
  • differential-expression/batch-correction - Correcting batch effects in analysis
  • single-cell/batch-integration - scRNA-seq batch correction

Signals

GitHub stars
178
Forks
32
Last commit
Jul 2026
Advanced
Catalog kind
skill
Gateway key
bio-experimental-design-batch-design
Source
github.com/biotender-max/awesome-bio-agent-skills