protocol-verification

Simulates and analyzes Opentrons protocols to verify correctness.

515|208|Updated Jul 6, 2015
One-click install
npx skills add https://github.com/Opentrons/opentrons --skill protocol-verification
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: protocol-verification
Source: https://github.com/Opentrons/opentrons/tree/main/.cursor/skills/protocol-verification
Command: npx skills add https://github.com/Opentrons/opentrons --skill protocol-verification

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Simulate and analyze Opentrons protocols to verify correctness. Use when asked to verify, simulate, analyze, validate, or check a protocol, or when needing to confirm a newly created protocol works.

Core Features & Use Cases

  • Simulate protocols to produce a human-readable runlog of robot steps.
  • Analyze protocols to produce structured JSON with commands, labware, pipettes, modules, and errors.
  • Quick validation checks in development workflows and CI to ensure protocol validity.

Quick Start

Run the verification workflow on a protocol by invoking the venv binaries for simulate and analyze on your protocol file.

Frequently Asked Questions about protocol-verification

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify an Opentrons protocol before running it on the robot?

You can verify an Opentrons protocol by simulating and analyzing its behavior to ensure correctness. This produces a human-readable runlog and structured JSON detailing commands, labware, pipettes, and errors before physical execution.

What is the difference between simulating and analyzing a protocol?

Simulating a protocol produces a human-readable runlog of robot steps, while analyzing a protocol outputs structured JSON containing commands, labware, pipettes, modules, and errors. Both validate protocol behavior during development.

Can I use protocol simulation and analysis for CI validation?

Yes, protocol simulation and analysis support quick validation checks in development workflows and CI. They confirm protocol validity by executing verification commands from the monorepo root to ensure protocols function as intended.

Do I need a specific environment to run Opentrons protocol verification?

Protocol verification relies on the api/.venv/bin/opentrons_simulate binary and the Python module opentrons.cli analyze. Commands must be executed from the monorepo root to properly access these dependencies.

What information do I get from analyzing an Opentrons protocol?

Analyzing an Opentrons protocol produces structured JSON with detailed information on commands, labware, pipettes, modules, and errors. This structured output helps identify issues and confirm the protocol configuration is valid.