Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-sequenced browser-automation skill with strong verification loops and a good reference table, but it is longer than necessary for the core file and ships dead references to missing template scripts.
Suggestions
Move niche sections (Experimental: Native Mode, Browser Engine Selection/lightpanda, iOS Simulator) into reference files so the core SKILL.md stays lean for the common case.
The 'Ready-to-Use Templates' section references templates/form-automation.sh, templates/authenticated-session.sh, and templates/capture-workflow.sh, none of which exist in the bundle — either ship those scripts or remove the section to avoid dead references.
Trim duplication between the inline 'Essential Commands'/'Common Patterns' blocks and references/commands.md by keeping only the most essential commands in the body and deferring the rest.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~535 lines of dense, executable command reference with terse comments and almost no conceptual padding, but it keeps several niche sections (Experimental: Native Mode, Browser Engine Selection, iOS Simulator) inline alongside a references/ system, so it could be tightened. | 2 / 3 |
Actionability | Nearly the entire body is copy-paste-ready `agent-browser` commands with concrete flags, expected output, and worked patterns like the form-submission and eval --stdin heredoc examples. | 3 / 3 |
Workflow Clarity | The Core Workflow is a clear 4-step Navigate->Snapshot->Interact->Re-snapshot sequence, reinforced by explicit verification checkpoints (Re-snapshot after DOM changes, 'snapshot -> action -> diff') and a dedicated Ref Lifecycle checklist. | 3 / 3 |
Progressive Disclosure | The Deep-Dive Documentation table signals 7 real one-level-deep reference files with a 'When to Use' column, but the 'Ready-to-Use Templates' section references templates/*.sh scripts that do not exist in the bundle, and sizable inline command/pattern blocks duplicate references/commands.md. | 2 / 3 |
Total | 10 / 12 Passed |