Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable with thorough executable code, but it functions as a monolithic inline API reference rather than a lean overview, and the referenced bundle files it points to are absent. Batch-operation workflows also lack explicit validation feedback loops.
Suggestions
Move the bulk of the per-method API reference (sections 2–8) into references/api_reference.md and keep SKILL.md as a concise overview with one-level-deep links, then actually create that file so the reference resolves.
Add an explicit validation workflow for batch liquid-handling protocols, e.g. 'simulate with opentrons_simulate → fix errors → re-simulate → only then run on robot', embedded in the Common Protocol Patterns rather than only as a best-practice bullet.
Create the referenced scripts/ directory with the example protocol templates mentioned in the Resources section, or remove the dangling reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids explaining basic concepts Claude already knows, but it is a ~560-line inline API reference that largely duplicates what the referenced 'references/api_reference.md' is meant to hold; it could be tightened by moving bulk reference material out of SKILL.md. | 2 / 3 |
Actionability | Provides extensive copy-paste-ready, executable code with real API names, parameter comments, and concrete examples (pipette loading, liquid handling, module control, serial dilution, PCR setup). | 3 / 3 |
Workflow Clarity | Common Protocol Patterns are sequenced, but batch/destructive liquid-handling workflows lack an explicit simulate→validate→fix→retry checkpoint; 'Simulate first' appears only as a best-practice bullet, capping clarity at 2 per the rubric. | 2 / 3 |
Progressive Disclosure | References to 'references/api_reference.md' and 'scripts/' are signaled, but those directories do not exist in the bundle, and the detailed API reference that should live in those files is inlined in SKILL.md rather than split out. | 2 / 3 |
Total | 9 / 12 Passed |