Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with executable commands, a clear validated workflow, and a clean one-level-deep reference architecture. Its main weakness is conciseness: substantial cross-section duplication (auth, viewport) inflates length, and three referenced template files are missing.
Suggestions
Consolidate authentication content: the five options in "Handling Authentication" are repeated in "Common Patterns" — keep one canonical treatment and point the other to it to cut length.
Fix or remove the templates section: `templates/form-automation.sh`, `templates/authenticated-session.sh`, and `templates/capture-workflow.sh` are referenced as runnable but do not exist, breaking the copy-paste-ready promise.
Tighten the viewport/device sections, which restate `set viewport` behavior and the `scale` parameter across "Essential Commands" and "Viewport & Responsive Testing".
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and command-driven, but ~640 lines with material repeated across sections — authentication appears as five options in "Handling Authentication" and again in "Common Patterns", and viewport behavior is restated multiple times — so it could be tightened rather than earning the 'every token earns its place' score-3 anchor. | 2 / 3 |
Actionability | Nearly all guidance is concrete, copy-paste-ready bash (e.g. `agent-browser open <url>`, `agent-browser snapshot -i`, `agent-browser fill @e1 "user@example.com"`), matching the fully-executable score-3 anchor; the score-2 pseudocode anchor does not fit. | 3 / 3 |
Workflow Clarity | A clear 4-step Core Workflow (Navigate → Snapshot → Interact → Re-snapshot) is reinforced by the Ref Lifecycle re-snapshot checkpoint and the snapshot→action→diff verification loop, providing explicit validation steps and error-recovery feedback. | 3 / 3 |
Progressive Disclosure | A well-signaled "Deep-Dive Documentation" table links seven real one-level-deep reference files, each with a "When to Use" column, matching the clear-overview score-3 anchor; the only blemish is that the referenced templates/*.sh files do not exist. | 3 / 3 |
Total | 11 / 12 Passed |