Content
85%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 strong, action-oriented skill body with executable examples, a clear sequenced workflow, and built-in validation (re-snapshot/diff). The main weakness is progressive disclosure: the 'Ready-to-Use Templates' table references a templates/ directory that is not present in the bundle.
Suggestions
Either add the templates/ directory with form-automation.sh, authenticated-session.sh, and capture-workflow.sh, or remove the 'Ready-to-Use Templates' section to avoid dangling references.
Tighten overlap between 'Essential Commands' and 'Common Patterns' (e.g., form/auth/session commands appear twice) to reduce redundancy and token cost.
Consider moving the verbose 'JavaScript Evaluation' rules-of-thumb explanation into references/ since commands.md can absorb it, keeping the body to the --stdin/-b pattern and a single example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and command-dense with minimal conceptual padding, but the 'Essential Commands' and 'Common Patterns' sections overlap (form/auth/session patterns repeat commands) and a few explanatory paragraphs ('Why this matters', rules of thumb) could be trimmed further. | 4 / 5 |
Actionability | Fully executable copy-paste-ready bash commands throughout, with concrete examples covering the common cases (navigate, snapshot, fill, click, wait, screenshot, eval) plus annotated output examples showing real refs. | 5 / 5 |
Workflow Clarity | Core Workflow is explicitly sequenced (Navigate -> Snapshot -> Interact -> Re-snapshot) with a validation/checkpoint pattern (re-snapshot after navigation, diff snapshot to verify changes) and the 'Ref Lifecycle' section codifies when to re-validate. | 5 / 5 |
Progressive Disclosure | Good use of a one-level-deep references table pointing to real files in references/, but the body also advertises a templates/ directory (3 .sh templates referenced) that does not exist in the bundle, leaving those links dangling. | 3 / 5 |
Total | 17 / 20 Passed |