qpcr-pipetting-plan

Generates bench-ready qPCR pipetting instructions and plate maps from a JSON experiment spec.

1|Updated Oct 25, 2020
One-click install
npx skills add https://github.com/bfairkun/dotfiles --skill qpcr-pipetting-plan-bfairkun
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qpcr-pipetting-plan
Source: https://github.com/bfairkun/dotfiles/tree/main/agents/.agents/skills/qpcr-pipetting-plan
Command: npx skills add https://github.com/bfairkun/dotfiles --skill qpcr-pipetting-plan-bfairkun

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires matplotlib, and includes scripts (resource) and assets (resource) components.

What problem does it solve? Planning a qPCR run by hand means error-prone volume math: scaling reactions for technical replicates, building mastermixes with dead volume, designing dilution-series standard curves, placing NTCs, and checking that every dispense fits the multichannel pipette range. This Skill turns a small JSON spec into a complete, validated pipetting sheet. ## Core Features & Use Cases - Deterministic volume calculations: Computes per-reaction, per-source-well, mastermix, template, dilution-series, and NTC volumes using the split-then-distribute recipe (oversized source wells split into 10 µL replicates), with reagent dead-volume headroom and pipette-increment rounding. - Plate layout generation: Produces a logical block-by-template map and a physical A1–H12 (8×12) source-plate assignment with PDF figures, plus multichannel range warnings (5–50 µL). - Flexible experiment designs: Supports primer pairs that skip the dilution series, multiple mastermixes per primer pair (e.g. commercial vs homemade SYBR), TaqMan 20× assays, and custom homemade mastermix recipes. - Use Case: You have 6 cDNA samples and 5 primer pairs to test, one of which also needs a standard curve under a second mastermix. Write the spec JSON, run the script, and get the full mastermix recipes, dilution series, NTCs, and a plate figure to confirm before pipetting. ## Quick Start Ask the assistant to plan a qPCR run with your samples and primer pairs, for example: "Plan a 3-replicate qPCR for 6 samples with these 4 primer pairs, 4-point 10-fold standard curves, and one NTC per block, then show me the plate map."

Frequently Asked Questions about qpcr-pipetting-plan

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

FAQPage Schema
How do I plan a qPCR plate layout with technical replicates?▼

Write a JSON spec listing replicates, samples, primer-pair blocks, and dilution-series settings, then run scripts/qpcr_plan.py with that spec. It computes oversized source wells (reps×10 + 5 µL) that are split into 10 µL replicates, and outputs logical and physical plate maps.

How do I calculate qPCR mastermix and primer volumes?▼

The script builds one primer-plus-mastermix per primer-pair and mastermix block: 5 µL of 2× mastermix plus primer from a 10 µM stock targeting 250 nM final per 10 µL reaction, scaled by well count with 10% dead volume. Dilution water rides with the template, not the mastermix.

Can I compare two mastermixes for the same qPCR primer pair?▼

Yes. Add a second block with the same primer name, a different mastermix string, samples set to false, and dilseries set to true. Each distinct mastermix string is totaled as its own 2× stock, so commercial and homemade SYBR mixes can run side by side.

Does the qPCR plan support TaqMan probe assays?▼

Yes. TaqMan assays ship as 20× stocks and are slotted at 0.5 µL per 10 µL reaction by setting primer_stock_uM accordingly. Put the TaqMan assay in its own block with a probe-capable mastermix string, since SYBR mastermixes cannot detect probes.

Why does the qPCR plan warn about multichannel pipette volumes?▼

Every dispense must fall within the multichannel range of 5–50 µL and snap to the pipette increment (default 0.5 µL). The script flags violations, which is why template volumes are kept at or above 5 µL by carrying dilution water with the template.

What are the limitations of the physical plate layout?▼

The physical layout assumes an 8×12 source plate with samples filling rows, so it requires n_samples ≤ 8 rows and dilution points plus NTC ≤ 8 rows. If columns exceed 12 or replicates overflow one plate, the script warns and you must assign additional wells or plates.