Content
90%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, highly actionable CLI reference with executable examples and a clear core workflow plus sensible validation checkpoints. The main room for improvement is splitting the large command catalog into a separate reference file and adding explicit error-recovery guidance for failed interactions.
Suggestions
Move the lengthy Commands catalog into a references/REFERENCE.md, keeping only the most common commands inline in SKILL.md with a clear pointer, to improve progressive disclosure.
Add an error-recovery checkpoint to the Core Workflow (e.g. re-run `snapshot -i` and retry the ref when a click/fill fails or a wait times out) to raise workflow clarity.
Note expected failure modes (element not found, navigation timeout) and the corresponding corrective command so the feedback loop is explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean command reference with terse inline comments and almost no prose padding (no explanation of what a browser or CDP is), so every token earns its place; matches the level-5 anchor rather than the minor-trimming level-4 anchor. | 5 / 5 |
Actionability | Commands are fully executable and copy-paste ready, with a worked example workflow (open, snapshot, fill, click, wait) covering common cases, matching the level-5 anchor; not a 4 because there are no missing key details in the examples. | 5 / 5 |
Workflow Clarity | The Core Workflow is a clear numbered sequence (open → snapshot -i → interact via refs → re-snapshot) with an explicit upfront availability check (`which agent-browser`) and a re-snapshot checkpoint, but there is no error-recovery feedback loop (e.g. what to do when a command fails), placing it at level-4 rather than 5. | 4 / 5 |
Progressive Disclosure | Content is organized into clearly headed sections (Core Workflow, Commands, Authentication, Iframes, Parallel Sessions, JavaScript Eval, Cleanup) with no nested references, which is good structure; it stays at 4 rather than 5 because the sizable inline Commands block could be split into a reference file and there are no one-level-deep references to offload detail. | 4 / 5 |
Total | 18 / 20 Passed |