Claude Code Plugins

Community-maintained marketplace

Feedback

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.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name dna-insert
description 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.

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:

  1. 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
  2. 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

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

Step 2: Design Initial Primers

For the forward primer:

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

For the reverse primer:

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

Step 3: Calculate Annealing Regions (Critical Step)

To correctly calculate annealing regions:

  1. Strip the insertion sequence from the primer - identify exactly where the insertion begins and ends within the primer
  2. Map remaining sequence to template - the portions before and after the insertion that match the template are the annealing regions
  3. 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:

  1. Extract annealing regions by removing insertion sequence from forward primer
  2. Confirm each annealing region is 15-45 bp
  3. Simulate the PCR product:
    • Concatenate: reverse_complement(reverse_primer) + forward_primer
    • Find the insertion within this concatenation
    • Verify flanking sequences match expected template regions
  4. Confirm the simulated product matches expected output sequence
  5. 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:

  1. Take reverse complement of reverse primer
  2. Concatenate with forward primer (this represents the amplified region)
  3. 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:

  1. Forward primer sequence with annotated regions:

    • Upstream annealing region (with length)
    • Insertion sequence (with length)
    • Downstream annealing region (with length)
  2. Reverse primer sequence with annotated annealing region

  3. Verification results:

    • Total annealing length for each primer
    • Tm values (calculated independently)
    • Confirmation that simulated PCR product matches expected output
  4. 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