Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable with clear workflows and validation checkpoints, but it underuses its own reference bundles — inlining a full command reference that duplicates commands.md instead of linking to it, and repeating the timeouts guidance across two sections.
Suggestions
Replace the inline 'Essential Commands' section with a brief command overview plus a pointer to references/commands.md, so the detailed reference lives one level deep rather than duplicated in the body.
Link to references/snapshot-refs.md from the 'Ref Lifecycle (Important)' section instead of restating ref mechanics inline.
Merge 'Timeouts and Slow Pages' into 'Timeouts and Cold-Start Cost' to remove the duplicated wait/wait --url guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient command/example density, but the inline 'Essential Commands' block duplicates the commands.md reference, and 'Timeouts and Slow Pages' repeats 'Timeouts and Cold-Start Cost' — content that could be tightened. | 2 / 3 |
Actionability | Fully executable, copy-paste-ready commands with concrete refs (@e1) and realistic chained examples — every token instructs rather than describes. | 3 / 3 |
Workflow Clarity | The Core Workflow is clearly sequenced (Navigate → Snapshot → Interact → Re-snapshot → Close) and the Ref Lifecycle section provides explicit re-snapshot validation checkpoints with WRONG/CORRECT contrast for error recovery. | 3 / 3 |
Progressive Disclosure | Bundle files commands.md and snapshot-refs.md exist but are never referenced from the body; instead their content is inlined as 'Essential Commands', so content that should be separate stays inline and navigation to the references is not signaled. | 2 / 3 |
Total | 10 / 12 Passed |