Content
82%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 highly actionable, well-structured CLI reference: every section is executable and the core workflow plus ref-lifecycle rule give clear sequencing. Weaknesses are mild — repeated command examples across sections, no explicit error-recovery guidance, and a large inline command reference that could be split into a bundle file.
Suggestions
Consolidate the repeated open/wait --load networkidle/snapshot -i examples that appear in Dev Server Verification, Command Chaining, and Timeouts into the Core Workflow to trim token usage.
Add a short error-recovery note (e.g., what to do when a ref is stale, an element isn't found, or a wait times out) to close the validation gap in the workflow.
Consider moving the full Essential Commands list and rarer patterns (PDF capture, diff, recording) into a references/ file, keeping SKILL.md as the workflow-focused overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean, command-first reference with essentially no explanation of concepts Claude already knows. It is not a 5 because command examples (open/wait --load networkidle/snapshot -i) repeat across the Dev Server Verification, Command Chaining, and Timeouts sections and could be consolidated. | 4 / 5 |
Actionability | Every snippet is an executable, copy-paste-ready command, and the pattern sections (form submission, auth with state persistence, data extraction, visual debugging) cover the common cases. Nothing is pseudocode or abstract. | 5 / 5 |
Workflow Clarity | The four-step core workflow (Navigate → Snapshot → Interact → Re-snapshot) is clearly sequenced, and the Ref Lifecycle section with 'MUST re-snapshot' and the wait guidance act as checkpoints. It is not a 5 because there is no explicit error-recovery guidance for failure modes like stale refs, missing elements, or timeouts. | 4 / 5 |
Progressive Disclosure | The single file is well-sectioned with clear headers and no nested references, so navigation is easy. It is not a 5 because ~100 lines of the body are an inline command/pattern reference with no bundle files or split-out advanced material, which is at the edge of what belongs in SKILL.md itself. | 4 / 5 |
Total | 17 / 20 Passed |