Content
92%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, lean command reference with a clear core workflow and an explicit ref-lifecycle feedback loop. Its main weakness is progressive disclosure: all detail lives inline in a single long file with no reference files to split out the command catalog.
Suggestions
Move the Essential Commands catalog into a references/COMMANDS.md (or similar) file, keeping SKILL.md as a concise overview that links to it, so the command reference is one level deep rather than inline.
Consolidate the repeated 'wait --load networkidle' and 'snapshot -i' pattern into the Core Workflow once, and have later pattern sections reference it instead of re-stating the full sequence each time.
De-duplicate the wait commands that appear in both Essential Commands and the Timeouts and Slow Pages section, pointing the latter back to the canonical reference to reduce inline repetition.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is command-dense with minimal inline commentary and no explanations of concepts Claude already knows (e.g., no 'what a browser is' filler); comments are short and load-bearing, so most tokens earn their place. | 3 / 3 |
Actionability | Every section provides fully executable, copy-paste-ready commands with real flags and refs (e.g., 'agent-browser fill @e2 "text"', 'agent-browser wait --load networkidle'), matching the anchor for concrete, specific, runnable guidance. | 3 / 3 |
Workflow Clarity | The Core Workflow gives an explicit 4-step sequence and the Ref Lifecycle section is a clear feedback loop (re-snapshot after navigation/submission/DOM changes), providing the validation-style checkpoint the top anchor rewards; no destructive/batch gap applies. | 3 / 3 |
Progressive Disclosure | The skill is well-sectioned but monolithic at ~195 lines with no bundle files: the Essential Commands block (~40 lines) and Timeout/Annotated sections repeat reference material inline that could be offloaded to a separate reference file, fitting the 'content that should be separate is inline' anchor rather than the one-level-deep reference ideal. | 2 / 3 |
Total | 11 / 12 Passed |