[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ET647XCS141F0GXYG4J2YN":3,"skill-same:01M7ET647XCS141F0GXYG4J2YN":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":14,"repositoryHtmlUrl":33,"repositoryHomepageUrl":33,"ownerHtmlUrl":34,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":35,"install":36,"resources":49},"01M7ET647XCS141F0GXYG4J2YN","bio-primer-design-qpcr-primers",null,"Co-designs qPCR\u002FRT-qPCR primers and hydrolysis (TaqMan) or molecular-beacon probes with primer3-py (PRIMER_PICK_INTERNAL_OLIGO, PRIMER_INTERNAL_* tags), for assays whose deliverable is a quantitative measurement device. Covers why amplification efficiency (90-110%, slope -3.6 to -3.1) and single-product specificity make the 2^-ddCq \u002F Pfaffl math valid, why the short amplicon (70-150 bp), tight Tm, and zero-dimer requirement exist, the coupled probe rules (probe Tm 8-10 C above primers so it is bound when Taq's exonuclease cleaves it; no 5' G as it quenches the reporter; C-rich strand; primer3 has NO no-5'-G tag so enforce PRIMER_INTERNAL_MUST_MATCH_FIVE_PRIME=HNNNN), gDNA exclusion by exon-junction spanning AND why pseudogenes defeat it, SYBR melt-curve QC, and reference-gene validation (geNorm\u002FNormFinder). Use when designing TaqMan\u002FSYBR assays, exon-spanning primers, probes, or matched-efficiency multiplex panels. Genome specificity is primer-specificity; dimers primer-validation; standard PCR primer-basics.","Mr-Nobody-Anonymous\u002FAll-skills","Mr-Nobody-Anonymous","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F184253119?v=4","01M7AEXFJHKTYQW5R0ZCQQTWFV","anonymous","01M7C00M3GQR4QKP9GZA42GFAK",0,"MIT","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fdesign\u002Fbio-primer-design-qpcr-primers\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: bio-primer-design-qpcr-primers\ndescription: Co-designs qPCR\u002FRT-qPCR primers and hydrolysis (TaqMan) or molecular-beacon probes with primer3-py (PRIMER_PICK_INTERNAL_OLIGO, PRIMER_INTERNAL_* tags), for assays whose deliverable is a quantitative measurement device. Covers why amplification efficiency (90-110%, slope -3.6 to -3.1) and single-product specificity make the 2^-ddCq \u002F Pfaffl math valid, why the short amplicon (70-150 bp), tight Tm, and zero-dimer requirement exist, the coupled probe rules (probe Tm 8-10 C above primers so it is bound when Taq's exonuclease cleaves it; no 5' G as it quenches the reporter; C-rich strand; primer3 has NO no-5'-G tag so enforce PRIMER_INTERNAL_MUST_MATCH_FIVE_PRIME=HNNNN), gDNA exclusion by exon-junction spanning AND why pseudogenes defeat it, SYBR melt-curve QC, and reference-gene validation (geNorm\u002FNormFinder). Use when designing TaqMan\u002FSYBR assays, exon-spanning primers, probes, or matched-efficiency multiplex panels. Genome specificity is primer-specificity; dimers primer-validation; standard PCR primer-basics.\ntool_type: python\nprimary_tool: primer3-py\nsource: \"https:\u002F\u002Fgithub.com\u002FGPTomics\u002FbioSkills\"\nsource_repository: \"GPTomics\u002FbioSkills\"\nsource_path: \"primer-design\u002Fqpcr-primers\u002FSKILL.md\"\nlicense: \"MIT\"\nimported_at: \"2026-09-20\"\n---\n\n## Version Compatibility\n\nReference examples tested with: primer3-py 2.3+.\n\nBefore using code patterns, verify installed versions match. If versions differ:\n- Python: `pip show primer3-py` then `help(primer3.design_primers)` to check signatures\n\nIf code throws ImportError, AttributeError, or TypeError, introspect the installed\npackage and adapt the example to match the actual API rather than retrying.\n\n# qPCR Primer and Probe Design -- Building a Quantitative Measurement Device\n\n**\"Design qPCR primers (and a probe) for this target\"** -> Co-design a short, single-product, Tm-matched amplicon with an optional internal probe whose constraints are coupled to the primers -- because the assay's job is not to amplify but to MEASURE, and every qPCR-specific rule protects the efficiency the quantification math assumes.\n- Python: `primer3.design_primers(seq_args, global_args)` with `PRIMER_PICK_INTERNAL_OLIGO=1` and `PRIMER_INTERNAL_*` for the probe.\n\nScope: co-designing qPCR\u002FRT-qPCR primers and hydrolysis\u002Fbeacon probes under coupled Tm\u002Fsize\u002Fjunction constraints. Genome-wide specificity \u002F pseudogene checking -> primer-specificity. Intramolecular dimers\u002Fhairpins of the oligos and probe -> primer-validation. Standard (non-quantitative) PCR -> primer-basics.\n\n## The Single Most Important Modern Insight -- A qPCR Assay Is a Measurement Device, and Efficiency Is a Parameter in the Equation, Not a QC Afterthought\n\n1. **Validity rests on efficiency and specificity.** A Cq difference maps to a true fold-change only through `(1+E)^-dCq` (at ideal E=1, `2^-ddCq`). That requires amplification efficiency E ~ 90-110% (standard-curve slope -3.6 to -3.1, R^2 > 0.99) AND a single product. The short amplicon (70-150 bp), tight Tm, and zero-dimer requirement all exist to protect E and specificity. `2^-ddCq` is valid ONLY when the target and reference-gene efficiencies are matched and near 100% -- so design for matched ~100% E, or fall back to Pfaffl's efficiency-corrected model.\n2. **The probe is coupled to the primers, not bolted on.** A hydrolysis probe must be BOUND when the polymerase extends through it (so Taq's 5'->3' exonuclease cleaves it and frees the reporter), which is why its Tm must sit 8-10 C ABOVE the primer Tm. It must NOT start with G (a 5'-G quenches the reporter even after cleavage), and the C-rich strand is preferred because G-richness anywhere near the reporter also quenches it. primer3's internal-oligo Tm defaults EQUAL the primer defaults, so they must be raised, and there is no dedicated no-5'-G tag -- enforce it with `PRIMER_INTERNAL_MUST_MATCH_FIVE_PRIME='HNNNN'` (IUPAC H = not G) or a post-hoc filter. This is the hydrolysis (TaqMan) probe path; a molecular beacon needs engineered complementary stem arms (a deliberate hairpin) that primer3's internal-oligo picker does NOT design and would flag as a liability -- design the linear core here, add the stem afterward, and exclude that hairpin from validation.\n3. **Design-level gDNA exclusion is real but leaky.** Exon-junction-spanning or intron-flanking primers reduce genomic-DNA amplification, but processed pseudogenes (intronless retro-copies that usually carry the junction) defeat junction-spanning, and tiny introns defeat flanking. So DNase + a no-RT control + a genome specificity check (-> primer-specificity) remain mandatory; single-exon genes have no design-level option at all.\n\n## The Quantification Math (Why the Constraints Exist)\n\nEfficiency from a standard curve: `E = 10^(-1\u002Fslope) - 1`; perfect doubling is slope -3.32 (E = 100%). Relative quantification with matched ~100% efficiency uses `2^-ddCq` (Livak & Schmittgen 2001 *Methods* 25:402); with UNEQUAL efficiencies use the efficiency-corrected ratio `E_target^dCq \u002F E_ref^dCq` (Pfaffl 2001 *Nucleic Acids Res* 29:e45). Report per MIQE (Bustin 2009 *Clin Chem* 55:611): efficiency, slope, R^2, Cq method, NTC and no-RT controls, and validated reference genes. The design objective is therefore \"single short amplicon with slope near -3.32,\" not \"two oligos that amplify.\"\n\n## Tool Taxonomy\n\n| Tool \u002F method | Citation | Mechanism \u002F role | When |\n|---------------|----------|------------------|------|\n| primer3-py internal oligo | Untergasser 2012 *Nucleic Acids Res* 40:e115 | `PRIMER_PICK_INTERNAL_OLIGO=1` + `PRIMER_INTERNAL_*` co-designs the probe with the primers | TaqMan \u002F hydrolysis-probe assays |\n| `PRIMER_INTERNAL_MUST_MATCH_FIVE_PRIME` | Untergasser 2012 *Nucleic Acids Res* 40:e115 | constrains the probe 5' end (use `HNNNN` to forbid 5'-G) | enforce the no-5'-G probe rule |\n| `SEQUENCE_OVERLAP_JUNCTION_LIST` | Untergasser 2012 *Nucleic Acids Res* 40:e115 | forces a primer\u002Fprobe to straddle a splice junction | cDNA-specific expression assays |\n| MIQE reporting | Bustin 2009 *Clin Chem* 55:611 | the minimum information \u002F efficiency-from-standard-curve standard | every quantitative assay |\n| geNorm \u002F NormFinder | Vandesompele 2002 *Genome Biol* 3:RESEARCH0034; Andersen 2004 *Cancer Res* 64:5245 | rank reference-gene stability | choosing normalizers, validated per condition |\n| In-silico PCR (genome) | (route OUT) | catches pseudogenes \u002F gDNA off-targets | mandatory gDNA\u002Fspecificity check -> primer-specificity |\n\n## Decision Tree by Scenario\n\n| Scenario | Recommended | Why |\n|----------|-------------|-----|\n| Probe-based (multiplex-capable, second specificity check) | TaqMan: `PRIMER_PICK_INTERNAL_OLIGO=1`, probe Tm 8-10 C above primers, `HNNNN` 5' | the probe adds sequence specificity and enables multiplex |\n| Single target, cheapest, no probe | SYBR (no internal oligo) + mandatory melt-curve QC | dye reports any dsDNA; melt curve is the specificity readout |\n| Expression assay, avoid gDNA | exon-junction-spanning primers (`SEQUENCE_OVERLAP_JUNCTION_LIST`) | the junction does not exist contiguously in unspliced gDNA |\n| Gene has a processed pseudogene | junction-spanning is NOT enough -> primer-specificity (search genome) + no-RT control | the pseudogene carries the junction |\n| Single-exon gene (no junction) | DNase + no-RT control; no design-level gDNA exclusion | there is no intron\u002Fjunction to exploit |\n| AT-rich target \u002F allele discrimination | MGB or LNA probe (shorter, higher effective Tm) | raises probe Tm where a standard probe cannot reach |\n| Multiplex panel | spectrally distinct fluorophores, matched E, primer-limiting, all-pairs cross-dimer | competition and cross-dimers dominate; primer-limiting = drop the abundant target's primer concentration so it plateaus early and stops starving the rare target of shared reagents |\n| Choosing normalizers | rank a candidate panel with geNorm\u002FNormFinder, validate per condition | a single unvalidated reference gene is a classic error |\n\nDefault when uncertain: TaqMan primers+probe, amplicon 70-150 bp, primers Tm ~60 C (within 2 C), probe Tm ~68-70 C with `HNNNN`, exon-junction-spanning for expression, then route the pair to primer-specificity and run a standard curve.\n\n## Co-Design Primers and a TaqMan Probe\n\n**Goal:** Produce a short, Tm-matched amplicon with an internal probe whose Tm is 8-10 C above the primers and whose 5' base is not G.\n\n**Approach:** Turn on internal-oligo picking, set the primer Tm window and a short product range, RAISE the `PRIMER_INTERNAL_*` Tm window 8-10 C above the primers (the defaults equal the primer Tm), and forbid a 5'-G probe with `PRIMER_INTERNAL_MUST_MATCH_FIVE_PRIME='HNNNN'`. For an expression assay add `SEQUENCE_OVERLAP_JUNCTION_LIST`.\n\n```python\nimport primer3\n\ntemplate = 'ATGC...'  # cDNA (mark the junction position if expression-specific)\n\nresult = primer3.design_primers(\n    seq_args={'SEQUENCE_ID': 'assay1', 'SEQUENCE_TEMPLATE': template},\n    global_args={\n        'PRIMER_PICK_LEFT_PRIMER': 1, 'PRIMER_PICK_RIGHT_PRIMER': 1,\n        'PRIMER_PICK_INTERNAL_OLIGO': 1,                 # design the probe\n        'PRIMER_PRODUCT_SIZE_RANGE': [[70, 150]],        # short amplicon for efficiency\n        'PRIMER_NUM_RETURN': 3,\n        'PRIMER_OPT_TM': 60.0, 'PRIMER_MIN_TM': 58.0, 'PRIMER_MAX_TM': 62.0,\n        'PRIMER_PAIR_MAX_DIFF_TM': 2.0,\n        'PRIMER_INTERNAL_OPT_TM': 70.0, 'PRIMER_INTERNAL_MIN_TM': 68.0, 'PRIMER_INTERNAL_MAX_TM': 72.0,\n        'PRIMER_INTERNAL_MUST_MATCH_FIVE_PRIME': 'HNNNN',  # IUPAC H = A\u002FC\u002FT = not G at the probe 5' end\n        # 'SEQUENCE_OVERLAP_JUNCTION_LIST': [junction_pos],  # add for cDNA-specific assays\n    })\n\nfor i in range(result['PRIMER_PAIR_NUM_RETURNED']):\n    probe = result[f'PRIMER_INTERNAL_{i}_SEQUENCE']\n    print(result[f'PRIMER_LEFT_{i}_SEQUENCE'], result[f'PRIMER_RIGHT_{i}_SEQUENCE'], probe,\n          'probe5=', probe[0], 'probeTm=', round(result[f'PRIMER_INTERNAL_{i}_TM'], 1),\n          'size=', result[f'PRIMER_PAIR_{i}_PRODUCT_SIZE'])\n```\n\n## Exon-Junction Spanning, and Its Limits\n\nFor a cDNA-specific assay, place a primer or the probe across a splice junction with `SEQUENCE_OVERLAP_JUNCTION_LIST = [pos]` plus `PRIMER_MIN_3_PRIME_OVERLAP_OF_JUNCTION` (default 4) and `PRIMER_MIN_5_PRIME_OVERLAP_OF_JUNCTION` (default 7); the 3' overlap is the specificity-determining knob because a primer that only overlaps at its 5' end can still prime off gDNA from its 3' anchor. The internal-oligo equivalents (`PRIMER_INTERNAL_MIN_3_PRIME_OVERLAP_OF_JUNCTION` \u002F `_5_PRIME_`) constrain the probe. The hard caveat: this does NOT protect against processed pseudogenes, which typically carry the junction in DNA -- so the assay still needs a genome specificity check (-> primer-specificity), DNase treatment, and a no-RT control. Intron-flanking (primers in different exons across a large intron) is the alternative, but fails across tiny introns.\n\n## Assembling a Multiplex Panel\n\nMultiplex is the most failure-prone mode; assemble it in order: (1) design each assay independently (short amplicon, matched Tm, probe offset); (2) check ALL primer+probe oligos pairwise for cross-dimers -- for k assays that is O((2k primers + k probes)^2) checks (a 5-plex = 10 primers + 5 probes = 105 pairwise calls), weighting 3'-end involvement (-> primer-validation); (3) run in-silico PCR over the POOLED primer set so cross-pair amplicons (one assay's forward meeting another's reverse) are caught (-> primer-specificity); (4) assign spectrally distinct fluorophores -- the instrument's optical channels and spectral overlap CAP the plex (most platforms resolve ~4-6 dyes, with color compensation), so the channel count, not the chemistry, usually limits a high-plex; (5) match efficiencies on a multiplex standard curve and primer-limit the abundant targets so they do not starve the rare ones.\n\n## Per-Method Failure Modes\n\n### Fold-changes reported without measuring efficiency\n**Trigger:** Applying `2^-ddCq` without a standard curve. **Mechanism:** the method assumes target and reference efficiencies are matched and ~100%; if not, fold-changes are systematically biased. **Symptom:** numbers that are not measurements; results that do not replicate across instruments. **Fix:** run a standard curve, report E\u002Fslope\u002FR^2 (MIQE), and use Pfaffl if efficiencies differ.\n\n### Probe Tm not 8-10 C above primers\n**Trigger:** Leaving `PRIMER_INTERNAL_*` Tm at the default (equal to the primers). **Mechanism:** the probe is not bound when the polymerase extends through it, so the exonuclease never cleaves it. **Symptom:** weak or no TaqMan signal. **Fix:** raise the internal Tm window 8-10 C above the primer window.\n\n### 5'-G on the probe\n**Trigger:** Not forbidding a 5' guanine. **Mechanism:** a 5'-G quenches the reporter even after cleavage. **Symptom:** low signal despite good amplification. **Fix:** `PRIMER_INTERNAL_MUST_MATCH_FIVE_PRIME='HNNNN'` or filter returned probes; prefer the C-rich strand.\n\n### Assuming exon-junction primers are gDNA-proof\n**Trigger:** Trusting junction-spanning alone. **Mechanism:** processed pseudogenes carry the spliced junction in genomic DNA. **Symptom:** a positive no-RT control; a genomic amplicon at the cDNA size. **Fix:** genome specificity check (primer-specificity), DNase, and a no-RT control.\n\n### Primer-dimers in a SYBR assay\n**Trigger:** Any extendable cross-dimer with SYBR detection. **Mechanism:** the dye reports the dimer, which competes with and can swamp a low-copy target. **Symptom:** a low-Tm shoulder in the melt curve; inflated NTC\u002Flow-copy signal. **Fix:** inspect the melt curve for a single sharp peak; validate dimers at reaction conditions (primer-validation).\n\n### Single, unvalidated reference gene\n**Trigger:** Normalizing to GAPDH\u002FACTB by habit. **Mechanism:** the reference may itself be regulated by the treatment. **Symptom:** apparent target changes that track a moving normalizer. **Fix:** rank a candidate panel with geNorm\u002FNormFinder and validate stability in the actual experimental conditions.\n\n## Quantitative Thresholds\n\n| Threshold | Source | Rationale |\n|-----------|--------|-----------|\n| Efficiency 90-110% (slope -3.6 to -3.1, ideal -3.32), R^2 > 0.99 | Bustin 2009 *Clin Chem* 55:611 | the acceptance band that keeps `2^-ddCq` valid |\n| Amplicon 70-150 bp | Bustin 2009 *Clin Chem* 55:611 | short products denature\u002Fre-prime fully each short cycle -> ~100% E |\n| Primer Tm ~58-62 C, pair within 2 C | Koressaar & Remm 2007 *Bioinformatics* 23:1289 | one anneal-extend temperature; matched so neither lags |\n| Probe Tm 8-10 C above primer Tm | -- | probe bound before\u002Fduring extension so the exonuclease can cleave it |\n| Probe: no 5'-G, prefer C-rich strand | -- | a 5'-G (and G-richness) quenches the reporter; the standard rule for 5'-reporter hydrolysis probes (reporter\u002Fquencher-chemistry dependent) |\n| Standard curve: 5-6 points, 10-fold, triplicate | Bustin 2009 *Clin Chem* 55:611 | defines E, R^2, dynamic range, LOD |\n| Reference genes: >=2 validated | Vandesompele 2002 *Genome Biol* 3:RESEARCH0034 | geometric mean of stable references beats one gene |\n\n## Common Errors\n\n| Error \u002F symptom | Cause | Solution |\n|-----------------|-------|----------|\n| Weak\u002Fno TaqMan signal | probe Tm too low, or 5'-G | raise `PRIMER_INTERNAL_*` Tm 8-10 C; `HNNNN`; C-rich strand |\n| No probe returned (0 pairs) | internal Tm window unreachable on this template | widen\u002Flower internal Tm or product range; check with `PRIMER_EXPLAIN_FLAG=1` |\n| Positive no-RT control | gDNA \u002F pseudogene amplification | junction-span + genome check (primer-specificity) + DNase |\n| Poor efficiency (slope steep\u002Fshallow) | amplicon too long, dimers, off-target, or template inhibitors\u002Fdegraded standard | shorten amplicon, fix dimers (primer-validation), check specificity, clean up template |\n| Low-Tm melt peak (SYBR) | primer-dimer | redesign to remove 3'-end cross-dimers (primer-validation) |\n| Fold-changes do not replicate | unmatched efficiency, unvalidated reference | match E or use Pfaffl; validate references with geNorm\u002FNormFinder |\n\n## References\n\n- Bustin SA, Benes V, Garson JA, et al. 2009. The MIQE guidelines: minimum information for publication of quantitative real-time PCR experiments. *Clin Chem* 55:611-622.\n- Untergasser A, Cutcutache I, Koressaar T, et al. 2012. Primer3 - new capabilities and interfaces. *Nucleic Acids Res* 40:e115.\n- Livak KJ, Schmittgen TD. 2001. Analysis of relative gene expression data using real-time quantitative PCR and the 2(-Delta Delta C(T)) method. *Methods* 25:402-408.\n- Pfaffl MW. 2001. A new mathematical model for relative quantification in real-time RT-PCR. *Nucleic Acids Res* 29:e45.\n- Vandesompele J, De Preter K, Pattyn F, et al. 2002. Accurate normalization of real-time quantitative RT-PCR data by geometric averaging of multiple internal control genes. *Genome Biol* 3:RESEARCH0034.\n- Andersen CL, Jensen JL, Orntoft TF. 2004. Normalization of real-time quantitative RT-PCR data: a model-based variance estimation approach to identify genes suited for normalization. *Cancer Res* 64:5245-5250.\n- Koressaar T, Remm M. 2007. Enhancements and modifications of primer design program Primer3. *Bioinformatics* 23:1289-1291.\n\n## Related Skills\n\n- primer-basics - Design fundamentals, Tm matching, and the constraint model\n- primer-validation - Dimers\u002Fhairpins of primers and probe at reaction conditions\n- primer-specificity - Genome\u002Fpseudogene specificity and gDNA exclusion checking\n- sequence-manipulation\u002Ftranscription-translation - Work with cDNA and reading frames\n- differential-expression\u002Fdeseq2-basics - Downstream analysis qPCR validates against\n","## Version Compatibility\n\nReference examples tested with: primer3-py 2.3+.\n\nBefore using code patterns, verify installed versions match. If versions differ:\n- Python: `pip show primer3-py` then `help(primer3.design_primers)` to check signatures\n\nIf code throws ImportError, AttributeError, or TypeError, introspect the installed\npackage and adapt the example to match the actual API rather than retrying.\n\n# qPCR Primer and Probe Design -- Building a Quantitative Measurement Device\n\n**\"Design qPCR primers (and a probe) for this target\"** -> Co-design a short, single-product, Tm-matched amplicon with an optional internal probe whose constraints are coupled to the primers -- because the assay's job is not to amplify but to MEASURE, and every qPCR-specific rule protects the efficiency the quantification math assumes.\n- Python: `primer3.design_primers(seq_args, global_args)` with `PRIMER_PICK_INTERNAL_OLIGO=1` and `PRIMER_INTERNAL_*` for the probe.\n\nScope: co-designing qPCR\u002FRT-qPCR primers and hydrolysis\u002Fbeacon probes under coupled Tm\u002Fsize\u002Fjunction constraints. Genome-wide specificity \u002F pseudogene checking -> primer-specificity. Intramolecular dimers\u002Fhairpins of the oligos and probe -> primer-validation. Standard (non-quantitative) PCR -> primer-basics.\n\n## The Single Most Important Modern Insight -- A qPCR Assay Is a Measurement Device, and Efficiency Is a Parameter in the Equation, Not a QC Afterthought\n\n1. **Validity rests on efficiency and specificity.** A Cq difference maps to a true fold-change only through `(1+E)^-dCq` (at ideal E=1, `2^-ddCq`). That requires amplification efficiency E ~ 90-110% (standard-curve slope -3.6 to -3.1, R^2 > 0.99) AND a single product. The short amplicon (70-150 bp), tight Tm, and zero-dimer requirement all exist to protect E and specificity. `2^-ddCq` is valid ONLY when the target and reference-gene efficiencies are matched and near 100% -- so design for matched ~100% E, or fall back to Pfaffl's efficiency-corrected model.\n2. **The probe is coupled to the primers, not bolted on.** A hydrolysis probe must be BOUND when the polymerase extends through it (so Taq's 5'->3' exonuclease cleaves it and frees the reporter), which is why its Tm must sit 8-10 C ABOVE the primer Tm. It must NOT start with G (a 5'-G quenches the reporter even after cleavage), and the C-rich strand is preferred because G-richness anywhere near the reporter also quenches it. primer3's internal-oligo Tm defaults EQUAL the primer defaults, so they must be raised, and there is no dedicated no-5'-G tag -- enforce it with `PRIMER_INTERNAL_MUST_MATCH_FIVE_PRIME='HNNNN'` (IUPAC H = not G) or a post-hoc filter. This is the hydrolysis (TaqMan) probe path; a molecular beacon needs engineered complementary stem arms (a deliberate hairpin) that primer3's internal-oligo picker does NOT design and would flag as a liability -- design the linear core here, add the stem afterward, and exclude that hairpin from validation.\n3. **Design-level gDNA exclusion is real but leaky.** Exon-junction-spanning or intron-flanking primers reduce genomic-DNA amplification, but processed pseudogenes (intronless retro-copies that usually carry the junction) defeat junction-spanning, and tiny introns defeat flanking. So DNase + a no-RT control + a genome specificity check (-> primer-specificity) remain mandatory; single-exon genes have no design-level option at all.\n\n## The Quantification Math (Why the Constraints Exist)\n\nEfficiency from a standard curve: `E = 10^(-1\u002Fslope) - 1`; perfect doubling is slope -3.32 (E = 100%). Relative quantification with matched ~100% efficiency uses `2^-ddCq` (Livak & Schmittgen 2001 *Methods* 25:402); with UNEQUAL efficiencies use the efficiency-corrected ratio `E_target^dCq \u002F E_ref^dCq` (Pfaffl 2001 *Nucleic Acids Res* 29:e45). Report per MIQE (Bustin 2009 *Clin Chem* 55:611): efficiency, slope, R^2, Cq method, NTC and no-RT controls, and validated reference genes. The design objective is therefore \"single short amplicon with slope near -3.32,\" not \"two oligos that amplify.\"\n\n## Tool Taxonomy\n\n| Tool \u002F method | Citation | Mechanism \u002F role | When |\n|---------------|----------|------------------|------|\n| primer3-py internal oligo | Untergasser 2012 *Nucleic Acids Res* 40:e115 | `PRIMER_PICK_INTERNAL_OLIGO=1` + `PRIMER_INTERNAL_*` co-designs the probe with the primers | TaqMan \u002F hydrolysis-probe assays |\n| `PRIMER_INTERNAL_MUST_MATCH_FIVE_PRIME` | Untergasser 2012 *Nucleic Acids Res* 40:e115 | constrains the probe 5' end (use `HNNNN` to forbid 5'-G) | enforce the no-5'-G probe rule |\n| `SEQUENCE_OVERLAP_JUNCTION_LIST` | Untergasser 2012 *Nucleic Acids Res* 40:e115 | forces a primer\u002Fprobe to straddle a splice junction | cDNA-specific expression assays |\n| MIQE reporting | Bustin 2009 *Clin Chem* 55:611 | the minimum information \u002F efficiency-from-standard-curve standard | every quantitative assay |\n| geNorm \u002F NormFinder | Vandesompele 2002 *Genome Biol* 3:RESEARCH0034; Andersen 2004 *Cancer Res* 64:5245 | rank reference-gene stability | choosing normalizers, validated per condition |\n| In-silico PCR (genome) | (route OUT) | catches pseudogenes \u002F gDNA off-targets | mandatory gDNA\u002Fspecificity check -> primer-specificity |\n\n## Decision Tree by Scenario\n\n| Scenario | Recommended | Why |\n|----------|-------------|-----|\n| Probe-based (multiplex-capable, second specificity check) | TaqMan: `PRIMER_PICK_INTERNAL_OLIGO=1`, probe Tm 8-10 C above primers, `HNNNN` 5' | the probe adds sequence specificity and enables multiplex |\n| Single target, cheapest, no probe | SYBR (no internal oligo) + mandatory melt-curve QC | dye reports any dsDNA; melt curve is the specificity readout |\n| Expression assay, avoid gDNA | exon-junction-spanning primers (`SEQUENCE_OVERLAP_JUNCTION_LIST`) | the junction does not exist contiguously in unspliced gDNA |\n| Gene has a processed pseudogene | junction-spanning is NOT enough -> primer-specificity (search genome) + no-RT control | the pseudogene carries the junction |\n| Single-exon gene (no junction) | DNase + no-RT control; no design-level gDNA exclusion | there is no intron\u002Fjunction to exploit |\n| AT-rich target \u002F allele discrimination | MGB or LNA probe (shorter, higher effective Tm) | raises probe Tm where a standard probe cannot reach |\n| Multiplex panel | spectrally distinct fluorophores, matched E, primer-limiting, all-pairs cross-dimer | competition and cross-dimers dominate; primer-limiting = drop the abundant target's primer concentration so it plateaus early and stops starving the rare target of shared reagents |\n| Choosing normalizers | rank a candidate panel with geNorm\u002FNormFinder, validate per condition | a single unvalidated reference gene is a classic error |\n\nDefault when uncertain: TaqMan primers+probe, amplicon 70-150 bp, primers Tm ~60 C (within 2 C), probe Tm ~68-70 C with `HNNNN`, exon-junction-spanning for expression, then route the pair to primer-specificity and run a standard curve.\n\n## Co-Design Primers and a TaqMan Probe\n\n**Goal:** Produce a short, Tm-matched amplicon with an internal probe whose Tm is 8-10 C above the primers and whose 5' base is not G.\n\n**Approach:** Turn on internal-oligo picking, set the primer Tm window and a short product range, RAISE the `PRIMER_INTERNAL_*` Tm window 8-10 C above the primers (the defaults equal the primer Tm), and forbid a 5'-G probe with `PRIMER_INTERNAL_MUST_MATCH_FIVE_PRIME='HNNNN'`. For an expression assay add `SEQUENCE_OVERLAP_JUNCTION_LIST`.\n\n```python\nimport primer3\n\ntemplate = 'ATGC...'  # cDNA (mark the junction position if expression-specific)\n\nresult = primer3.design_primers(\n    seq_args={'SEQUENCE_ID': 'assay1', 'SEQUENCE_TEMPLATE': template},\n    global_args={\n        'PRIMER_PICK_LEFT_PRIMER': 1, 'PRIMER_PICK_RIGHT_PRIMER': 1,\n        'PRIMER_PICK_INTERNAL_OLIGO': 1,                 # design the probe\n        'PRIMER_PRODUCT_SIZE_RANGE': [[70, 150]],        # short amplicon for efficiency\n        'PRIMER_NUM_RETURN': 3,\n        'PRIMER_OPT_TM': 60.0, 'PRIMER_MIN_TM': 58.0, 'PRIMER_MAX_TM': 62.0,\n        'PRIMER_PAIR_MAX_DIFF_TM': 2.0,\n        'PRIMER_INTERNAL_OPT_TM': 70.0, 'PRIMER_INTERNAL_MIN_TM': 68.0, 'PRIMER_INTERNAL_MAX_TM': 72.0,\n        'PRIMER_INTERNAL_MUST_MATCH_FIVE_PRIME': 'HNNNN',  # IUPAC H = A\u002FC\u002FT = not G at the probe 5' end\n        # 'SEQUENCE_OVERLAP_JUNCTION_LIST': [junction_pos],  # add for cDNA-specific assays\n    })\n\nfor i in range(result['PRIMER_PAIR_NUM_RETURNED']):\n    probe = result[f'PRIMER_INTERNAL_{i}_SEQUENCE']\n    print(result[f'PRIMER_LEFT_{i}_SEQUENCE'], result[f'PRIMER_RIGHT_{i}_SEQUENCE'], probe,\n          'probe5=', probe[0], 'probeTm=', round(result[f'PRIMER_INTERNAL_{i}_TM'], 1),\n          'size=', result[f'PRIMER_PAIR_{i}_PRODUCT_SIZE'])\n```\n\n## Exon-Junction Spanning, and Its Limits\n\nFor a cDNA-specific assay, place a primer or the probe across a splice junction with `SEQUENCE_OVERLAP_JUNCTION_LIST = [pos]` plus `PRIMER_MIN_3_PRIME_OVERLAP_OF_JUNCTION` (default 4) and `PRIMER_MIN_5_PRIME_OVERLAP_OF_JUNCTION` (default 7); the 3' overlap is the specificity-determining knob because a primer that only overlaps at its 5' end can still prime off gDNA from its 3' anchor. The internal-oligo equivalents (`PRIMER_INTERNAL_MIN_3_PRIME_OVERLAP_OF_JUNCTION` \u002F `_5_PRIME_`) constrain the probe. The hard caveat: this does NOT protect against processed pseudogenes, which typically carry the junction in DNA -- so the assay still needs a genome specificity check (-> primer-specificity), DNase treatment, and a no-RT control. Intron-flanking (primers in different exons across a large intron) is the alternative, but fails across tiny introns.\n\n## Assembling a Multiplex Panel\n\nMultiplex is the most failure-prone mode; assemble it in order: (1) design each assay independently (short amplicon, matched Tm, probe offset); (2) check ALL primer+probe oligos pairwise for cross-dimers -- for k assays that is O((2k primers + k probes)^2) checks (a 5-plex = 10 primers + 5 probes = 105 pairwise calls), weighting 3'-end involvement (-> primer-validation); (3) run in-silico PCR over the POOLED primer set so cross-pair amplicons (one assay's forward meeting another's reverse) are caught (-> primer-specificity); (4) assign spectrally distinct fluorophores -- the instrument's optical channels and spectral overlap CAP the plex (most platforms resolve ~4-6 dyes, with color compensation), so the channel count, not the chemistry, usually limits a high-plex; (5) match efficiencies on a multiplex standard curve and primer-limit the abundant targets so they do not starve the rare ones.\n\n## Per-Method Failure Modes\n\n### Fold-changes reported without measuring efficiency\n**Trigger:** Applying `2^-ddCq` without a standard curve. **Mechanism:** the method assumes target and reference efficiencies are matched and ~100%; if not, fold-changes are systematically biased. **Symptom:** numbers that are not measurements; results that do not replicate across instruments. **Fix:** run a standard curve, report E\u002Fslope\u002FR^2 (MIQE), and use Pfaffl if efficiencies differ.\n\n### Probe Tm not 8-10 C above primers\n**Trigger:** Leaving `PRIMER_INTERNAL_*` Tm at the default (equal to the primers). **Mechanism:** the probe is not bound when the polymerase extends through it, so the exonuclease never cleaves it. **Symptom:** weak or no TaqMan signal. **Fix:** raise the internal Tm window 8-10 C above the primer window.\n\n### 5'-G on the probe\n**Trigger:** Not forbidding a 5' guanine. **Mechanism:** a 5'-G quenches the reporter even after cleavage. **Symptom:** low signal despite good amplification. **Fix:** `PRIMER_INTERNAL_MUST_MATCH_FIVE_PRIME='HNNNN'` or filter returned probes; prefer the C-rich strand.\n\n### Assuming exon-junction primers are gDNA-proof\n**Trigger:** Trusting junction-spanning alone. **Mechanism:** processed pseudogenes carry the spliced junction in genomic DNA. **Symptom:** a positive no-RT control; a genomic amplicon at the cDNA size. **Fix:** genome specificity check (primer-specificity), DNase, and a no-RT control.\n\n### Primer-dimers in a SYBR assay\n**Trigger:** Any extendable cross-dimer with SYBR detection. **Mechanism:** the dye reports the dimer, which competes with and can swamp a low-copy target. **Symptom:** a low-Tm shoulder in the melt curve; inflated NTC\u002Flow-copy signal. **Fix:** inspect the melt curve for a single sharp peak; validate dimers at reaction conditions (primer-validation).\n\n### Single, unvalidated reference gene\n**Trigger:** Normalizing to GAPDH\u002FACTB by habit. **Mechanism:** the reference may itself be regulated by the treatment. **Symptom:** apparent target changes that track a moving normalizer. **Fix:** rank a candidate panel with geNorm\u002FNormFinder and validate stability in the actual experimental conditions.\n\n## Quantitative Thresholds\n\n| Threshold | Source | Rationale |\n|-----------|--------|-----------|\n| Efficiency 90-110% (slope -3.6 to -3.1, ideal -3.32), R^2 > 0.99 | Bustin 2009 *Clin Chem* 55:611 | the acceptance band that keeps `2^-ddCq` valid |\n| Amplicon 70-150 bp | Bustin 2009 *Clin Chem* 55:611 | short products denature\u002Fre-prime fully each short cycle -> ~100% E |\n| Primer Tm ~58-62 C, pair within 2 C | Koressaar & Remm 2007 *Bioinformatics* 23:1289 | one anneal-extend temperature; matched so neither lags |\n| Probe Tm 8-10 C above primer Tm | -- | probe bound before\u002Fduring extension so the exonuclease can cleave it |\n| Probe: no 5'-G, prefer C-rich strand | -- | a 5'-G (and G-richness) quenches the reporter; the standard rule for 5'-reporter hydrolysis probes (reporter\u002Fquencher-chemistry dependent) |\n| Standard curve: 5-6 points, 10-fold, triplicate | Bustin 2009 *Clin Chem* 55:611 | defines E, R^2, dynamic range, LOD |\n| Reference genes: >=2 validated | Vandesompele 2002 *Genome Biol* 3:RESEARCH0034 | geometric mean of stable references beats one gene |\n\n## Common Errors\n\n| Error \u002F symptom | Cause | Solution |\n|-----------------|-------|----------|\n| Weak\u002Fno TaqMan signal | probe Tm too low, or 5'-G | raise `PRIMER_INTERNAL_*` Tm 8-10 C; `HNNNN`; C-rich strand |\n| No probe returned (0 pairs) | internal Tm window unreachable on this template | widen\u002Flower internal Tm or product range; check with `PRIMER_EXPLAIN_FLAG=1` |\n| Positive no-RT control | gDNA \u002F pseudogene amplification | junction-span + genome check (primer-specificity) + DNase |\n| Poor efficiency (slope steep\u002Fshallow) | amplicon too long, dimers, off-target, or template inhibitors\u002Fdegraded standard | shorten amplicon, fix dimers (primer-validation), check specificity, clean up template |\n| Low-Tm melt peak (SYBR) | primer-dimer | redesign to remove 3'-end cross-dimers (primer-validation) |\n| Fold-changes do not replicate | unmatched efficiency, unvalidated reference | match E or use Pfaffl; validate references with geNorm\u002FNormFinder |\n\n## References\n\n- Bustin SA, Benes V, Garson JA, et al. 2009. The MIQE guidelines: minimum information for publication of quantitative real-time PCR experiments. *Clin Chem* 55:611-622.\n- Untergasser A, Cutcutache I, Koressaar T, et al. 2012. Primer3 - new capabilities and interfaces. *Nucleic Acids Res* 40:e115.\n- Livak KJ, Schmittgen TD. 2001. Analysis of relative gene expression data using real-time quantitative PCR and the 2(-Delta Delta C(T)) method. *Methods* 25:402-408.\n- Pfaffl MW. 2001. A new mathematical model for relative quantification in real-time RT-PCR. *Nucleic Acids Res* 29:e45.\n- Vandesompele J, De Preter K, Pattyn F, et al. 2002. Accurate normalization of real-time quantitative RT-PCR data by geometric averaging of multiple internal control genes. *Genome Biol* 3:RESEARCH0034.\n- Andersen CL, Jensen JL, Orntoft TF. 2004. Normalization of real-time quantitative RT-PCR data: a model-based variance estimation approach to identify genes suited for normalization. *Cancer Res* 64:5245-5250.\n- Koressaar T, Remm M. 2007. Enhancements and modifications of primer design program Primer3. *Bioinformatics* 23:1289-1291.\n\n## Related Skills\n\n- primer-basics - Design fundamentals, Tm matching, and the constraint model\n- primer-validation - Dimers\u002Fhairpins of primers and probe at reaction conditions\n- primer-specificity - Genome\u002Fpseudogene specificity and gDNA exclusion checking\n- sequence-manipulation\u002Ftranscription-translation - Work with cDNA and reading frames\n- differential-expression\u002Fdeseq2-basics - Downstream analysis qPCR validates against\n",{"name":5,"source":24,"license":15,"tool_type":25,"description":7,"imported_at":26,"source_path":27,"primary_tool":28,"source_repository":29},"https:\u002F\u002Fgithub.com\u002FGPTomics\u002FbioSkills","python","2026-09-20","primer-design\u002Fqpcr-primers\u002FSKILL.md","primer3-py","GPTomics\u002FbioSkills","main","2d1750717747097b602acf30bd09a7cbd4b4c6ea","awesome_skills\u002Fdesign\u002Fbio-primer-design-qpcr-primers","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous","2026-11-09 11:45:36",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-primer-design-qpcr-primers",{"tool":42,"command":43},"bunx","bunx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-primer-design-qpcr-primers",{"tool":45,"command":46},"pnpm","pnpm dlx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-primer-design-qpcr-primers","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fdesign\u002Fbio-primer-design-qpcr-primers\u002FSKILL.md",true,[50,56],{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"examples\u002Fqpcr_design.py","SCRIPT","脚本",2678,"https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fdesign\u002Fbio-primer-design-qpcr-primers\u002Fexamples\u002Fqpcr_design.py",{"path":57,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":60,"sourceHtmlUrl":61},"usage-guide.md","REFERENCE","参考文档",5171,"https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fdesign\u002Fbio-primer-design-qpcr-primers\u002Fusage-guide.md",[63,71,78,85,92,99],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":70},"01M7FFFZPC2025JQQHPHDX154J","dei-assessment","Assess diversity, equity, and inclusion with metrics. TRIGGERS - Use when user needs help with dei-assessment related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fdei-assessment\u002FSKILL.md",[],[],"2026-11-16 10:05:34",{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":70},"01M7FFFWN8H4WA7A6Y398QKB6J","dei-action-plan","Create DEI action plans with goals and initiatives. TRIGGERS - Use when user needs help with dei-action-plan related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fdei-action-plan\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":70},"01M7FFFSHTM0QZRVZ2NRJTJ0PY","culture-fit-assessment","Design culture add assessment processes. TRIGGERS - Use when user needs help with culture-fit-assessment related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fculture-fit-assessment\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":70},"01M7FFFMA12RKEQA38KHJSXXPS","cowork-to-code-bridge","Use an already-installed, independently verified cowork-to-code bridge to run narrowly approved actions on the user's own macOS, Linux, or WSL2 machine through a local file queue.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fcowork-to-code-bridge\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":70},"01M7FFFH1F6M8YRGW5V487GH1K","counter-offer-response","Draft counter-offer responses for retention. TRIGGERS - Use when user needs help with counter-offer-response related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fcounter-offer-response\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":70},"01M7FFFDGEHV8Y7J9N40HZXW52","continuous-feedback-system","Design continuous feedback systems. TRIGGERS - Use when user needs help with continuous-feedback-system related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fcontinuous-feedback-system\u002FSKILL.md",[],[]]