Content
72%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 concrete commands and a recommended snapshot workflow, and it uses progressive disclosure well by pointing to two real reference files. Its main weaknesses are inline duplication of reference material and the absence of explicit validation/error-recovery checkpoints in the workflow.
Suggestions
Add explicit validation checkpoints to the workflow (e.g. after login/form submission, snapshot and confirm expected URL or element before proceeding) and a brief retry-on-failure loop for auth flows.
Trim the Quick Reference command tables, which overlap heavily with references/browser-automation.md, to reduce token cost and duplication; keep only the highest-frequency commands inline.
Consolidate the 'MCP browser tool usage' and 'Notes' sections or move them into a reference, since they are secondary to the core workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and avoids explaining generic concepts, but it duplicates a large command reference inline (Quick Reference tables) that largely repeats content delegated to the references files, which could be tightened. | 2 / 3 |
Actionability | Every step is concrete and executable: exact commands (`agent-browser snapshot -i -c`, `agent-browser click @e2`), real example output with refs, and copy-paste-ready command tables. | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced (Step 0 through Step 3) and snapshot-before-act is emphasized, but there are no explicit validation/verification checkpoints or error-recovery feedback loops for risky operations (e.g. login/auth, form submission), capping clarity at 2 per the destructive/batch-operations note. | 2 / 3 |
Progressive Disclosure | The SKILL.md is a clear overview with two well-signaled, one-level-deep references (browser-automation.md, ai-snapshot-workflow.md) that both exist as real files in ./references/, and detail is appropriately split rather than deeply nested. | 3 / 3 |
Total | 10 / 12 Passed |