opentrons-thermocycler
Skill45 starsChanged 20 days agoMITView on GitHub
Opentrons Thermocycler Module - automated PCR thermal cycling with independent block (4-99°C) and lid (37-110°C) temperature control, profile execution, and auto-sealing lid support (GEN2) for high-throughput molecular biology workflows
In this repository45 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- phd-qualifierSkill
- citation-verifierSkill
- scientific-writingSkill
- brainstormingSkill
- elevenlabsSkill
- image-generationSkill
- presentationsSkill
- video-storytellingSkill
- code-reviewerSkill
- ralph-wiggumSkill
- tddSkill
- version-controlSkill
- hamilton-starSkill
- opentrons-absorbance-readerSkill
- opentrons-gripperSkill
- opentrons-heater-shakerSkill
- opentrons-magnetic-blockSkill
- opentronsSkill
- opentrons-temperature-moduleSkill
- planningSkill
- claude-lightSkill
- emacs-lispSkill
- fairchemSkill
- idaesSkill
- materials-propertiesSkill
- pycalphadSkill
- pymatgenSkill
- python-aseSkill
- python-best-practicesSkill
- python-jaxSkill
- python-multiobjective-optimizationSkill
- python-optimizationSkill
- python-plottingSkill
- python-regression-statisticsSkill
- vaspSkill
- pycseSkill
- elnSkill
- literature-reviewSkill
- materials-databasesSkill
- scientific-data-extractionSkill
- scientific-reviewerSkill
- scientific-workflowsSkill
- design-of-experimentsSkill
- troubleshootingSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
17 rules. About 0 are common, 17 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈17
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 17
Use the Thermocycler skill when:
- Distinctive: line 305
Important: Do not affix rubber seal to internal Thermocycler lid when using auto-sealing lids.
- Distinctive: line 571
Use Opentrons Tough PCR Auto-sealing Lids
- Distinctive: line 584
Test profiles with simulation: - Verify timing before running on hardware
- Distinctive: line 649
Verify temperature is within range (4-99°C block, 37-110°C lid)
- Distinctive: line 650
Check ambient temperature for low-temp targets
- Distinctive: line 654
Ensure lid temperature is set and reached before cycling
- Distinctive: line 656
Verify lid is properly closed
- Distinctive: line 659
Check profile structure (list of dicts with temperature and hold_time_seconds)
- Distinctive: line 660
Verify repetitions parameter is provided
- Distinctive: line 661
Ensure block_max_volume matches sample volume
- Distinctive: line 664
Wait for block to cool below 60°C
- Distinctive: line 665
Use plate lift mechanism (GEN2)
- Distinctive: line 666
Ensure lid is fully open
- Distinctive: line 669
Verify lid is open before movement
- Distinctive: line 670
Check plate is compatible PCR labware
- Distinctive: line 671
Ensure thermocycler position is clear
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Opentrons Thermocycler Module
Overview
The Opentrons Thermocycler Module automates PCR thermal cycling with precise, independent control of block temperature (4-99°C) and heated lid (37-110°C). Execute complex temperature profiles with automatic cycling, integrate with liquid handling for complete PCR setup automation, and use auto-sealing lids (GEN2) for walk-away workflows.
Core value: Fully automate PCR setup and cycling. Load samples, dispense reagents, seal plates (GEN2), run thermal profiles, and collect products—all without manual intervention.
When to Use
Use the Thermocycler skill when:
- Running PCR amplification protocols
- Performing qPCR or RT-PCR reactions
- Automating DNA/RNA thermal cycling workflows
- Executing multi-step temperature incubations
- Integrating thermal cycling with automated liquid handling
- Setting up high-throughput PCR screening
Don't use when:
- Simple temperature control needed (use Temperature Module for 4-95°C range)
- Shaking/mixing required during incubation (use Heater-Shaker Module)
- Temperature outside 4-99°C range (block) or 37-110°C (lid)
Quick Reference
| Operation | Method | Key Parameters |
| Load module | protocol.load_module() | "thermocyclerModuleV2" or "thermocyclerModuleV1" |
| Open lid | open_lid() | - |
| Close lid | close_lid() | - |
| Set lid temperature | set_lid_temperature() | celsius (37-110) |
| Deactivate lid | deactivate_lid() | - |
| Set block temperature | set_block_temperature() | celsius (4-99), hold_time, block_max_volume |
| Execute profile | execute_profile() | steps, repetitions, block_max_volume |
| Deactivate block | deactivate_block() | - |
Platform Compatibility
Both Opentrons Flex and OT-2
Module Generations
- GEN1 - Original thermocycler, OT-2 only
- GEN2 - Improved plate lift mechanism, auto-sealing lid support
API compatibility: Both generations support identical API methods
Deck Position
OT-2: Spans multiple deck slots (typically slots 7, 8, 10, 11)
Flex: Dedicated thermocycler position
Loading:
# No deck slot specified - thermocycler has fixed position
tc_mod = protocol.load_module("thermocyclerModuleV2")Loading the Module
from opentrons import protocol_api
metadata = {'apiLevel': '2.19'}
def run(protocol: protocol_api.ProtocolContext):
# Load Thermocycler Module (no location - fixed position)
tc_mod = protocol.load_module("thermocyclerModuleV2")
# Load PCR plate
pcr_plate = tc_mod.load_labware("opentrons_96_wellplate_200ul_pcr_full_skirt")Module versions:
"thermocyclerModuleV1"- GEN1"thermocyclerModuleV2"- GEN2 (recommended)
Lid Control
Basic Lid Operations
# Open lid for pipette access
tc_mod.open_lid()
# Close lid for thermal cycling
tc_mod.close_lid()Important for gripper (Flex):
- Always open lid before gripper operations
- Close lid only after plate is seated on thermocycler
Heated Lid
The heated lid prevents condensation during thermal cycling:
# Set lid temperature (blocks until reached)
tc_mod.set_lid_temperature(celsius=105)
# Run thermal profile
# ... cycling ...
# Turn off lid heater
tc_mod.deactivate_lid()Lid temperature range: 37-110°C
Typical settings:
- Standard PCR: 105°C
- RT-PCR: 100-105°C
- Custom protocols: Match or exceed highest block temperature + 5-10°C
Note: Lid temperature is independent of block temperature and profiles.
Block Temperature Control
Basic Block Temperature
# Set block temperature and wait
tc_mod.set_block_temperature(
temperature=95,
hold_time_seconds=180, # Hold for 3 minutes
block_max_volume=50 # Volume in wells (µL)
)
# Block automatically maintains temperature for hold_timeBlock temperature range: 4-99°C
Parameters:
temperature- Target temperature in °C (required)hold_time_seconds- Duration to hold at temperaturehold_time_minutes- Alternative duration in minutesblock_max_volume- Sample volume in µL (default: 25µL)
Hold Time Behavior
With hold_time: Protocol waits at temperature for specified duration
# Wait 5 minutes at 95°C
tc_mod.set_block_temperature(
temperature=95,
hold_time_minutes=5,
block_max_volume=50
)
# Protocol continues after 5 minutesWithout hold_time: Set temperature and continue immediately
# Set to 4°C and proceed (no hold)
tc_mod.set_block_temperature(temperature=4)
# Can perform other operations while maintaining 4°CBlock Max Volume
Specify sample volume for improved temperature accuracy:
# 50µL reactions
tc_mod.set_block_temperature(
temperature=72,
hold_time_minutes=10,
block_max_volume=50 # Optimizes heating/cooling for 50µL
)Default: 25µL if not specified
Why it matters: Algorithm adjusts for thermal mass of liquid to ensure accurate sample temperature.
Temperature Profiles
Automate repeated temperature cycles for PCR:
Defining a Profile
# PCR profile: Denature → Anneal → Extend
pcr_profile = [
{"temperature": 95, "hold_time_seconds": 30}, # Denaturation
{"temperature": 57, "hold_time_seconds": 30}, # Annealing
{"temperature": 72, "hold_time_seconds": 60} # Extension
]Profile structure: List of dictionaries with temperature and hold_time_seconds
Executing a Profile
# Run profile for 30 cycles
tc_mod.execute_profile(
steps=pcr_profile,
repetitions=30,
block_max_volume=50
)Parameters:
steps- List of temperature steps (required)repetitions- Number of times to repeat profile (required)block_max_volume- Sample volume in µL
Complete PCR Protocol
# Setup
tc_mod = protocol.load_module("thermocyclerModuleV2")
pcr_plate = tc_mod.load_labware("opentrons_96_wellplate_200ul_pcr_full_skirt")
# Open lid for loading
tc_mod.open_lid()
# Pipette PCR reagents (not shown)
# ... add template, primers, polymerase, etc. ...
# Close lid and set lid temperature
tc_mod.close_lid()
tc_mod.set_lid_temperature(105)
# Initial denaturation
tc_mod.set_block_temperature(
temperature=95,
hold_time_seconds=180, # 3 minutes
block_max_volume=50
)
# PCR cycling
pcr_profile = [
{"temperature": 95, "hold_time_seconds": 30},
{"temperature": 57, "hold_time_seconds": 30},
{"temperature": 72, "hold_time_seconds": 60}
]
tc_mod.execute_profile(steps=pcr_profile, repetitions=30, block_max_volume=50)
# Final extension
tc_mod.set_block_temperature(
temperature=72,
hold_time_minutes=5,
block_max_volume=50
)
# Hold at 4°C
tc_mod.set_block_temperature(temperature=4)
# Cleanup
tc_mod.deactivate_lid()
tc_mod.deactivate_block()
tc_mod.open_lid()Auto-Sealing Lids (GEN2)
Opentrons Flex GEN2 Thermocycler supports auto-sealing lids for walk-away protocols:
Auto-Sealing Lid Labware
# Load auto-sealing lid and riser
auto_seal_lid = protocol.load_labware(
"opentrons_tough_pcr_auto_sealing_lid",
location="lid_stack_location"
)
riser = protocol.load_labware(
"opentrons_flex_deck_riser",
location="deck_location"
)Lid Stack Management
# Load auto-sealing lids as labware on a deck riser
lid_on_riser = protocol.load_labware(
"opentrons_tough_pcr_auto_sealing_lid",
"D2",
adapter="opentrons_flex_deck_riser"
)
# Stack additional lids on top (up to 5 total)
lid_2 = lid_on_riser.load_labware("opentrons_tough_pcr_auto_sealing_lid")
# Move lid onto PCR plate with gripper
protocol.move_labware(lid_on_riser, pcr_plate, use_gripper=True)Important: Do not affix rubber seal to internal Thermocycler lid when using auto-sealing lids.
Complete Workflow with Auto-Sealing
# Load module and labware
tc_mod = protocol.load_module("thermocyclerModuleV2")
pcr_plate = tc_mod.load_labware("opentrons_96_wellplate_200ul_pcr_full_skirt")
# Load auto-sealing lid on deck riser
seal_lid = protocol.load_labware(
"opentrons_tough_pcr_auto_sealing_lid",
"D2",
adapter="opentrons_flex_deck_riser"
)
# Setup samples
tc_mod.open_lid()
# ... pipette reagents ...
# Apply auto-sealing lid with gripper
protocol.move_labware(seal_lid, pcr_plate, use_gripper=True)
# Close thermocycler lid
tc_mod.close_lid()
# Run PCR
# ... thermal cycling ...
# Open for retrieval
tc_mod.open_lid()Common Patterns
Standard PCR
# Standard Taq PCR protocol
tc_mod.close_lid()
tc_mod.set_lid_temperature(105)
# Initial denaturation
tc_mod.set_block_temperature(95, hold_time_minutes=3, block_max_volume=50)
# Cycling
standard_pcr = [
{"temperature": 95, "hold_time_seconds": 30},
{"temperature": 55, "hold_time_seconds": 30},
{"temperature": 72, "hold_time_seconds": 60}
]
tc_mod.execute_profile(steps=standard_pcr, repetitions=35, block_max_volume=50)
# Final extension
tc_mod.set_block_temperature(72, hold_time_minutes=10, block_max_volume=50)
# Hold at 4°C
tc_mod.set_block_temperature(4)
tc_mod.deactivate_lid()
tc_mod.deactivate_block()
tc_mod.open_lid()Gradient PCR (Multiple Annealing Temperatures)
# Test multiple annealing temperatures in columns
annealing_temps = [52, 54, 56, 58, 60, 62, 64, 66] # 8 temperatures
for i, temp in enumerate(annealing_temps):
protocol.comment(f"Column {i+1}: {temp}°C annealing")
# Pipette samples into column (example)
# pipette.transfer(50, master_mix, pcr_plate.columns()[i])
# Run gradient PCR for this column
gradient_profile = [
{"temperature": 95, "hold_time_seconds": 30},
{"temperature": temp, "hold_time_seconds": 30}, # Variable annealing
{"temperature": 72, "hold_time_seconds": 60}
]
tc_mod.execute_profile(steps=gradient_profile, repetitions=30, block_max_volume=50)Note: This example is simplified. True gradient PCR requires hardware that supports simultaneous temperature gradients across the block.
Two-Step PCR (No Extension)
# Two-step PCR (denature + anneal/extend combined)
tc_mod.close_lid()
tc_mod.set_lid_temperature(105)
tc_mod.set_block_temperature(95, hold_time_minutes=3, block_max_volume=25)
two_step = [
{"temperature": 95, "hold_time_seconds": 15},
{"temperature": 60, "hold_time_seconds": 60} # Combined anneal/extend
]
tc_mod.execute_profile(steps=two_step, repetitions=40, block_max_volume=25)
tc_mod.set_block_temperature(4)
tc_mod.deactivate_lid()
tc_mod.deactivate_block()
tc_mod.open_lid()RT-PCR (Reverse Transcription + PCR)
# Reverse transcription + PCR
tc_mod.close_lid()
tc_mod.set_lid_temperature(100)
# Reverse transcription
tc_mod.set_block_temperature(42, hold_time_minutes=30, block_max_volume=20)
# RT inactivation
tc_mod.set_block_temperature(85, hold_time_minutes=5, block_max_volume=20)
# Cool for PCR enzyme addition (if needed)
tc_mod.set_block_temperature(4)
tc_mod.open_lid()
# Add PCR enzymes
# pipette.transfer(...)
tc_mod.close_lid()
tc_mod.set_lid_temperature(105)
# PCR cycling
tc_mod.set_block_temperature(95, hold_time_minutes=2, block_max_volume=25)
rt_pcr_profile = [
{"temperature": 95, "hold_time_seconds": 15},
{"temperature": 60, "hold_time_seconds": 30},
{"temperature": 72, "hold_time_seconds": 30}
]
tc_mod.execute_profile(steps=rt_pcr_profile, repetitions=40, block_max_volume=25)
tc_mod.set_block_temperature(4)
tc_mod.deactivate_lid()
tc_mod.deactivate_block()
tc_mod.open_lid()Touchdown PCR
# Touchdown PCR - decreasing annealing temperature
tc_mod.close_lid()
tc_mod.set_lid_temperature(105)
tc_mod.set_block_temperature(95, hold_time_minutes=3, block_max_volume=50)
# High stringency cycles (65°C → 55°C, -1°C per cycle)
for temp in range(65, 54, -1):
touchdown_profile = [
{"temperature": 95, "hold_time_seconds": 30},
{"temperature": temp, "hold_time_seconds": 30},
{"temperature": 72, "hold_time_seconds": 60}
]
tc_mod.execute_profile(steps=touchdown_profile, repetitions=1, block_max_volume=50)
# Lower stringency cycles (55°C for remaining)
standard_profile = [
{"temperature": 95, "hold_time_seconds": 30},
{"temperature": 55, "hold_time_seconds": 30},
{"temperature": 72, "hold_time_seconds": 60}
]
tc_mod.execute_profile(steps=standard_profile, repetitions=25, block_max_volume=50)
tc_mod.set_block_temperature(72, hold_time_minutes=10, block_max_volume=50)
tc_mod.set_block_temperature(4)
tc_mod.deactivate_lid()
tc_mod.deactivate_block()
tc_mod.open_lid()Integration with Liquid Handling
Automated PCR Setup
# Complete automated PCR setup
tc_mod = protocol.load_module("thermocyclerModuleV2")
pcr_plate = tc_mod.load_labware("opentrons_96_wellplate_200ul_pcr_full_skirt")
pipette = protocol.load_instrument("flex_1channel_1000", "left")
# Reagents
master_mix = protocol.load_labware("opentrons_24_tuberack_nest_1.5ml_snapcap", "C1")
template_plate = protocol.load_labware("biorad_96_wellplate_200ul_pcr", "C2")
# Open thermocycler
tc_mod.open_lid()
# Distribute master mix
pipette.distribute(
volume=45,
source=master_mix["A1"],
dest=pcr_plate.wells(),
new_tip="once"
)
# Add template DNA
pipette.transfer(
volume=5,
source=template_plate.wells(),
dest=pcr_plate.wells(),
mix_after=(3, 25),
new_tip="always"
)
# Run PCR
tc_mod.close_lid()
tc_mod.set_lid_temperature(105)
tc_mod.set_block_temperature(95, hold_time_minutes=3, block_max_volume=50)
pcr_profile = [
{"temperature": 95, "hold_time_seconds": 30},
{"temperature": 58, "hold_time_seconds": 30},
{"temperature": 72, "hold_time_seconds": 60}
]
tc_mod.execute_profile(steps=pcr_profile, repetitions=30, block_max_volume=50)
tc_mod.set_block_temperature(72, hold_time_minutes=5, block_max_volume=50)
tc_mod.set_block_temperature(4)
tc_mod.deactivate_lid()
tc_mod.deactivate_block()
tc_mod.open_lid()Integration with Gripper (Flex)
# Prepare samples off-deck, move to thermocycler
sample_plate = protocol.load_labware("opentrons_96_wellplate_200ul_pcr_full_skirt", "C2")
# Setup samples
# ... pipetting ...
# Move to thermocycler with gripper
tc_mod.open_lid()
protocol.move_labware(sample_plate, tc_mod, use_gripper=True)
# Run PCR
tc_mod.close_lid()
# ... thermal cycling ...
# Retrieve plate
tc_mod.open_lid()
protocol.move_labware(sample_plate, "C2", use_gripper=True)GEN2 Improvements
Plate lift mechanism:
- Press button for 3 seconds with lid open to activate
- Raises plate for easier manual or gripper removal
- Improves plate access and prevents damage
Auto-sealing lid support:
- Use Opentrons Tough PCR Auto-sealing Lids
- Stack up to 5 lids
- Automated lid placement with gripper
Best Practices
- Set lid temperature before cycling - Prevents condensation
- Use block_max_volume parameter - Improves temperature accuracy
- Deactivate block and lid at protocol end - Prevents equipment running indefinitely
- Open lid before gripper operations - Required for plate movement
- Use profiles for repeated cycles - More efficient than individual set_block_temperature calls
- Cool to 4°C at end - Preserves samples until retrieval
- Plan for thermal equilibration - Allow extra time for large temperature changes
- Test profiles with simulation - Verify timing before running on hardware
- Document profile parameters - Include reasoning in protocol comments
- Consider enzyme specifications - Match temperatures to polymerase requirements
Common Mistakes
❌ Not setting lid temperature:
tc_mod.close_lid()
tc_mod.execute_profile(...) # Condensation risk - no lid heating✅ Correct:
tc_mod.close_lid()
tc_mod.set_lid_temperature(105)
tc_mod.execute_profile(...)❌ Gripper movement with closed lid:
protocol.move_labware(plate, tc_mod, use_gripper=True) # Error: lid closed✅ Correct:
tc_mod.open_lid()
protocol.move_labware(plate, tc_mod, use_gripper=True)❌ Not deactivating modules:
tc_mod.execute_profile(...)
# Protocol ends - thermocycler still heating!✅ Correct:
tc_mod.execute_profile(...)
tc_mod.deactivate_lid()
tc_mod.deactivate_block()❌ Wrong profile structure:
# Missing hold_time_seconds
bad_profile = [
{"temperature": 95},
{"temperature": 55}
]
tc_mod.execute_profile(steps=bad_profile, repetitions=30) # Error✅ Correct:
good_profile = [
{"temperature": 95, "hold_time_seconds": 30},
{"temperature": 55, "hold_time_seconds": 30}
]
tc_mod.execute_profile(steps=good_profile, repetitions=30)Troubleshooting
Module not reaching temperature:
- Verify temperature is within range (4-99°C block, 37-110°C lid)
- Check ambient temperature for low-temp targets
- Allow sufficient time for thermal equilibration
Condensation in wells:
- Ensure lid temperature is set and reached before cycling
- Set lid temperature ≥ highest block temperature + 5-10°C
- Verify lid is properly closed
Profile not executing:
- Check profile structure (list of dicts with temperature and hold_time_seconds)
- Verify repetitions parameter is provided
- Ensure block_max_volume matches sample volume
Plate removal difficulty (GEN1):
- Wait for block to cool below 60°C
- Use plate lift mechanism (GEN2)
- Ensure lid is fully open
Gripper errors:
- Verify lid is open before movement
- Check plate is compatible PCR labware
- Ensure thermocycler position is clear
Integration with Other Modules
With Temperature Module (Pre-cooling)
temp_mod = protocol.load_module("temperature module gen2", "D1")
tc_mod = protocol.load_module("thermocyclerModuleV2")
# Pre-cool samples on temperature module
temp_mod.set_temperature(4)
protocol.move_labware(sample_plate, temp_mod, use_gripper=True)
protocol.delay(minutes=5)
# Transfer to thermocycler
tc_mod.open_lid()
protocol.move_labware(sample_plate, tc_mod, use_gripper=True)
# Run PCR
tc_mod.close_lid()
# ... thermal cycling ...With Magnetic Module (PCR Cleanup)
# After PCR, perform magnetic bead cleanup
tc_mod.set_block_temperature(4)
tc_mod.open_lid()
mag_block = protocol.load_module("magneticBlockV1", "D2")
# Move PCR product to magnetic block
protocol.move_labware(pcr_plate, mag_block, use_gripper=True)
# Cleanup workflow
# ... magnetic bead purification ...API Version Requirements
- Minimum API version: 2.0 (thermocycler support)
- GEN2 features: API 2.13+
- Auto-sealing lids: API 2.15+
- Recommended: 2.19+ for full feature support
Additional Resources
- Thermocycler Documentation: https://docs.opentrons.com/v2/modules/thermocycler.html
- PCR Protocol Library: https://protocols.opentrons.com/
- Opentrons Support: https://support.opentrons.com/
Related Skills
opentrons- Main Opentrons Python API skillopentrons-temperature-module- Simple temperature control (4-95°C)opentrons-gripper- Automated labware movement (Flex)opentrons-magnetic-block- Magnetic bead separation for PCR cleanup
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

