dna-insert

Original：🇺🇸 English

Translated

Guide for designing DNA insertion primers for site-directed mutagenesis (SDM) using Q5 or similar kits. This skill should be used when tasks involve inserting DNA sequences into plasmids, designing mutagenesis primers, or working with PCR-based insertion methods. Provides verification strategies, common pitfalls, and procedural guidance for correct primer design.

1installs

Sourceletta-ai/skills

Added on2026-02-15

NPX Install

npx skill4agent add letta-ai/skills dna-insert

SKILL.md Content

View Translation Comparison →

DNA Insert Primer Design

Overview

This skill provides procedural guidance for designing primers to insert DNA sequences into existing plasmids using site-directed mutagenesis (SDM) kits like NEB's Q5 SDM kit. The skill emphasizes verification strategies and common pitfalls to avoid incorrect primer designs.

When to Use This Skill

Designing primers to insert a DNA sequence at a specific position in a plasmid
Q5 Site-Directed Mutagenesis (SDM) primer design for insertions
PCR-based insertion of sequences into circular DNA templates
Verifying primer designs meet annealing length and Tm requirements

Critical Concepts

Primer Structure for Insertions

For Q5 SDM insertions, primers have specific structural requirements:

Forward Primer Structure:
```
[5' upstream annealing] - [INSERTION] - [3' downstream annealing]
```
- The insertion sequence is typically placed at or near the 5' end
- The 3' portion MUST anneal to the template for proper extension
- The 3' annealing region is critical for polymerase binding
Reverse Primer Structure: Anneals adjacent to the insertion site on the opposite strand
- Must be back-to-back with the forward primer's annealing region
- Typically does not contain insertion sequence

Annealing Region Requirements

Minimum annealing length: 15 nucleotides (per NEB guidelines)
Maximum annealing length: 45 nucleotides
Both primers must meet this requirement independently
The annealing region is ONLY the portion that hybridizes to the original template

Procedural Workflow

Step 1: Identify the Insertion Site and Sequence

Align input sequence with output sequence to find differences
Identify the exact insertion sequence (what is being added)
Identify the exact position in the template where insertion occurs
Verification: Confirm that
```
input_sequence + insertion = output_sequence
```
at the identified position

Step 2: Design Initial Primers

For the forward primer:

Include sufficient 3' annealing sequence AFTER the insertion (minimum 15 bp)
Include the complete insertion sequence
Include 5' annealing sequence upstream of the insertion site

For the reverse primer:

Design to anneal immediately adjacent to the insertion site
Use reverse complement orientation
Ensure minimum 15 bp annealing length

Step 3: Calculate Annealing Regions (Critical Step)

To correctly calculate annealing regions:

Strip the insertion sequence from the primer - identify exactly where the insertion begins and ends within the primer
Map remaining sequence to template - the portions before and after the insertion that match the template are the annealing regions
Sum only template-matching portions - insertion sequence does NOT count toward annealing length

Common Mistake: Counting insertion sequence as part of annealing region. The insertion does NOT anneal to anything - only template-complementary regions anneal.

Step 4: Verify Tm Values

Calculate Tm for annealing regions only (not including insertion)
Use appropriate Tm calculator (e.g.,
```
oligotm
```
from primer3, NEB Tm calculator)
Target Tm typically 60-72°C depending on kit requirements
Verify independently: Do not rely on self-written verification scripts

Step 5: Validate the Design

Independent verification checklist:

Extract annealing regions by removing insertion sequence from forward primer
Confirm each annealing region is 15-45 bp
Simulate the PCR product:
- Concatenate: reverse_complement(reverse_primer) + forward_primer
- Find the insertion within this concatenation
- Verify flanking sequences match expected template regions
Confirm the simulated product matches expected output sequence
Check primers do not form significant secondary structures or dimers

Verification Strategies

Strategy 1: Boundary Verification

After identifying insertion boundaries:

original_template[0:insert_pos] + insertion + original_template[insert_pos:] == expected_output

If this equation fails, the insertion position or sequence is incorrect.

Strategy 2: Primer Decomposition

For the forward primer, explicitly identify:

Characters 1-N: upstream annealing (must match template)
Characters N+1 to M: insertion sequence (must match identified insertion)
Characters M+1 to end: downstream annealing (must match template)

Verify each segment independently by alignment to template.

Strategy 3: PCR Product Simulation

Simulate what the primers would produce:

Take reverse complement of reverse primer
Concatenate with forward primer (this represents the amplified region)
The result should match the expected output sequence

Strategy 4: Independent Tool Verification

Use
```
oligotm
```
command-line tool to verify Tm calculations
Use BLAST or local alignment to verify primer specificity
Cross-check with NEB's online Tm calculator

Common Pitfalls

Pitfall 1: Insufficient 3' Annealing

Problem: Placing too much sequence upstream of the insertion, leaving insufficient 3' annealing.

Why it matters: The 3' end of the primer is where polymerase binds and begins extension. Insufficient 3' annealing leads to poor or no amplification.

Solution: Ensure at least 15 bp of template-complementary sequence at the 3' end of the forward primer.

Pitfall 2: Self-Confirming Verification

Problem: Writing verification code that uses the same logic as the design code.

Why it matters: If the original logic is flawed, the verification will confirm incorrect results.

Solution: Use completely independent methods for verification. Simulate the actual PCR product and compare to expected output.

Pitfall 3: Miscounting Insertion Boundaries

Problem: Incorrectly identifying where the insertion sequence starts and ends within the designed primer.

Why it matters: Leads to incorrect annealing length calculations and potentially non-functional primers.

Solution: Use string search/alignment to explicitly find the insertion sequence within the primer, then verify the flanking regions independently.

Pitfall 4: Ignoring Circular Plasmid Considerations

Problem: Not accounting for the circular nature of plasmids when the insertion site is near the origin.

Why it matters: Primer placement may need to span the origin, affecting design strategy.

Solution: For insertions near the plasmid origin, consider the sequence as circular when identifying flanking regions.

Pitfall 5: Asymmetric Annealing Without Justification

Problem: Designing primers with highly asymmetric annealing regions (e.g., 33 bp upstream, 4 bp downstream).

Why it matters: May indicate a design error; both flanking regions should typically be balanced.

Solution: If annealing regions are highly asymmetric, re-verify the insertion boundary calculations.

Output Format Guidance

When providing primer designs, include:

Forward primer sequence with annotated regions:
- Upstream annealing region (with length)
- Insertion sequence (with length)
- Downstream annealing region (with length)
Reverse primer sequence with annotated annealing region
Verification results:
- Total annealing length for each primer
- Tm values (calculated independently)
- Confirmation that simulated PCR product matches expected output
Explicit boundary positions in the original template

Checklist Before Finalizing

Forward primer 3' annealing region is at least 15 bp
Reverse primer annealing region is at least 15 bp
Neither annealing region exceeds 45 bp
Insertion sequence is correctly positioned within forward primer
Simulated PCR product matches expected output sequence
Tm values are within acceptable range (verified independently)
No significant secondary structures or primer dimers
Primers do not have multiple binding sites in the plasmid