New to Claude Skills? Learn how to install them →

mims-harvard on GitHub

PCR Primer Design

Free

Efficiently design and QC PCR primers with ease.

Get this skill

Free · Opens the source repo

What PCR Primer Design does

The PCR Primer Design skill provides users with a comprehensive toolset for designing forward and reverse primers for PCR and qPCR applications. By utilizing Santa Lucia's nearest-neighbor thermodynamics, this skill allows you to compute essential parameters such as melting temperature (Tm) and annealing temperature (Ta), while also checking for GC content and potential secondary structures like hairpins and primer-dimers. This makes it an invaluable resource for researchers and developers who need reliable primer design for their experiments.

To get started, you can design a primer pair by specifying a target DNA sequence along with the desired target region and product size constraints. The skill will return the designed primers along with their properties, ensuring they meet the necessary criteria for successful amplification. Additionally, the skill includes a quality control script that checks existing primer pairs against established design rules, helping to identify potential issues before proceeding with experiments.

This skill is particularly useful when you need to design primers for specific sequences or validate existing primers to ensure they meet the required standards. It covers essential primer design rules, such as length, Tm matching, GC content, and the avoidance of problematic secondary structures, providing a thorough framework for effective primer design. However, users should be aware that while the skill addresses thermodynamic properties, it does not check for genome specificity, which must be handled separately.

Overall, the PCR Primer Design skill streamlines the primer design process, reducing the likelihood of experimental failure due to poorly designed primers. It is ideal for molecular biologists, genetic engineers, and anyone involved in PCR-based research who requires a reliable and efficient method for designing and validating primers.

When to use it

Use this skill when you need to design primers for PCR or qPCR, or when you need to validate existing primers for quality and performance.

When not to use it

This skill is not suitable for checking genome specificity or for empirical performance validation; those aspects must be handled separately.

What you can build with it

Designing New Primers

Use the skill to create a forward and reverse primer pair for a new DNA sequence, ensuring they meet Tm and GC content requirements.

Validating Existing Primers

Check the quality of an existing primer pair by running it through the QC script to identify any design flaws.

Calculating Tm for Specific Primers

Input primer sequences to calculate their melting temperatures and recommended annealing temperatures for optimal PCR conditions.

How to install PCR Primer Design

View source

1. Install with the skills CLI

npx skills add mims-harvard/tooluniverse/tooluniverse-primer-design --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by mims-harvard

PCR / qPCR Primer & Oligo Design

Design primers for a target DNA region, get their Tm/Ta, and QC them for the secondary-structure problems that make a PCR fail.

When to use this

  • Design a forward/reverse primer pair to amplify a region of a sequence.
  • Compute the Tm / annealing temperature of a primer.
  • QC an existing primer pair (GC clamp, 3'-end, hairpins, self/cross dimers, Tm match).

Step 1 — Design a primer pair

tu run DNA_primer_design '{"operation":"primer_design",
  "sequence":"ATGGCG...AACGTG",        # full template; must be >= target_end + flanking primer room
  "target_start":40, "target_end":125,
  "tm_target":60, "product_size_min":80, "product_size_max":140}'

Returns forward_primer / reverse_primer (sequence, tm, gc_content, length, position) and product_size. (target_end is clamped to the sequence length, so a too-short template silently shrinks the target — see the constraint quirk below.)

Constraint quirk — read this or it will error. target_start..target_end is the region the amplicon must cover, and the design only succeeds when that span fits inside the product-size window AND good-Tm primers can be placed flanking it. So you need roughly: product_size_min ≤ (target span) ≤ product ≤ product_size_max, with enough flanking sequence on both sides. Common errors and the fix:

  • "Target region (N bp) is smaller than product_size_min" → your target is narrower than product_size_min; lower product_size_min or widen the target.
  • "product does not cover the target / does not span" → the target is too wide for product_size_max, or runs too close to a sequence end; widen product_size_max or give more flanking sequence.

Step 2 — Get Tm / annealing temperature for specific primers

tu run NEB_Tm_calculate '{"primer_sequence":"CTACCTGAAGAACCTGAG",
  "primer_sequence_2":"CTTGATGTCCTCCAGCAT",
  "polymerase":"Q5", "primer_concentration":500, "monovalent_salt_mm":50}'

NEB returns Tm for each primer and a recommended annealing temperature (Ta) for the chosen polymerase. IDT_analyze_oligo (sequence, salt/Mg/dNTP/oligo concentrations) adds GC%, molecular weight, and hairpin / self-dimer screening. DNA_calculate_gc_content is a quick GC check.

Tm depends on method + conditions. SantaLucia NN (the design tool), NEB, and IDT use different parameter sets, and Tm shifts with monovalent salt, Mg²⁺, and primer/dNTP concentration. Pick one calculator + condition set and use it for the whole experiment; don't compare a SantaLucia Tm to an IDT Tm. Always state the conditions.

Step 3 — Primer design rules (what "good" looks like)

PropertyTargetWhy
Length18–24 ntlong enough for specificity, short enough for efficient annealing
Tm58–62 °Cworks with standard cycling; keep the pair within ~2–3 °C of each other
ΔTm (forward vs reverse)< 3 °C (≤5 absolute max)mismatched Tm → one primer anneals poorly
GC content40–60 %balanced stability
GC clamp1–2 G/C in the last 3 nt of the 3′ endstabilizes 3′ priming; >3 G/C risks mispriming
3′ endavoid 3′ complementarity within a pair and within a primerprevents primer-dimers
Runs / repeatsavoid ≥4 identical bases in a row and di-nucleotide repeatsreduce slippage / mispriming
Annealing temp (Ta)~ Tm − 3 to −5 °C (use the polymerase's calculator)specificity vs yield
Amplicon (qPCR)70–150 bpefficient amplification

scripts/primer_qc.py checks a primer pair against these rules (GC clamp, 3′ self/cross-complementarity, runs, GC%, length, Wallace/NN Tm, Tm match) and flags problems — use it to QC primers from any source.

Step 4 — Specificity (the tools do NOT do this)

Tm and structure are necessary but not sufficient. A primer can be thermodynamically perfect and still amplify the wrong locus. These tools do not check genome specificity — always BLAST each primer (or use Primer-BLAST) against the target genome and confirm a single intended product before ordering. State this in any recommendation.

Step 5 — Common gotchas

  • Forgetting specificity (Step 4) — the #1 cause of a "well-designed" primer failing.
  • Mismatched pair Tm — design tries to match, but a hand-picked pair often isn't; check ΔTm.
  • 3′ primer-dimers — 3′ complementarity between forward and reverse is the classic dimer; IDT_analyze_oligo / the QC script flag it.
  • Tm method/condition mixing (Step 2).
  • Secondary structure in the template (GC-rich/hairpin regions) can block priming even with good primers — consider additives or moving the target.

Honest limitations

  • Thermodynamic Tm/structure prediction ≠ empirical performance; validate by gradient PCR.
  • No genome-specificity check (Step 4) and no SNP-masking — handle those separately.

Related skills

  • tooluniverse-sequence-analysis — upstream sequence handling (FASTQ, alignment, coverage).
  • tooluniverse-enzyme-kinetics / tooluniverse-dose-response — other quantitative assay analyses.

Frequently asked questions about PCR Primer Design

Similar skills