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, token-efficient CLI reference: fully executable commands, well-categorized sections, and worked examples that demonstrate the snapshot-ref-interact loop. The main improvements are adding error-recovery guidance for failed interactions and splitting the exhaustive command catalog into a one-level-deep reference file.
Suggestions
Add a short troubleshooting/error-recovery note for common failures (stale refs after DOM changes, element not found, timing-sensitive pages) to strengthen the feedback loop.
Move the exhaustive command catalog (Navigation, Get information, Cookies & Storage, JavaScript) into a references/COMMANDS.md and keep Quick start + Core workflow + examples in SKILL.md for progressive disclosure.
Trim the Quick start commands that are repeated verbatim in the Commands section, or merge the two to remove the duplication.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean command reference with inline comments and no explanation of concepts Claude already knows; every command line carries real information. The only trim candidate is the minor duplication between the Quick start block and the Commands section (open/snapshot/click/fill/close appear in both), which keeps it just below the 'every token earns its place' anchor — well above level 3's 'unnecessary explanation'. | 4 / 5 |
Actionability | Every snippet is a copy-paste-ready executable command, the full command catalog is concrete, and three worked examples (form submission, data extraction, auth with saved state) cover the common cases — matching the top anchor for fully executable, example-covered guidance. | 5 / 5 |
Workflow Clarity | The Core workflow gives a clear 4-step sequence (navigate, snapshot, interact, re-snapshot) and the examples include verification checkpoints ('wait --load networkidle', 'snapshot -i # Check result'). It falls short of level 5 because there are no explicit error-recovery steps (e.g., what to do when a ref is stale or an element isn't found), though no destructive/batch cap applies. | 4 / 5 |
Progressive Disclosure | Sections are well-organized with clear headers (Quick start, Commands by category, Examples) and no nested or buried references — but no bundle files exist and the entire CLI command catalog is inlined in SKILL.md rather than split into a references file, a minor organization gap matching the level-4 anchor 'most content is appropriately placed'. | 4 / 5 |
Total | 17 / 20 Passed |