Content
71%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.
The browse skill content itself is highly actionable and well-sequenced, with copy-paste commands and embedded verification steps. The weaknesses are the large amount of inlined gstack meta-boilerplate that dilutes token efficiency and the absence of any bundle files, leaving a monolithic SKILL.md with an inlined API reference.
Suggestions
Move the full command list and snapshot-flag reference into a references/ file (e.g. references/commands.md) and keep only the core QA patterns and most-used commands in SKILL.md, with clearly signaled one-level-deep links.
Move the gstack preamble boilerplate (telemetry prompting, proactive prompting, lake intro, contributor mode, plan-status footer) into a shared reference file or the framework's own skill, cutting ~200 lines of non-browse tokens from this file.
Remove or contextualize the pinned BUN_VERSION=1.3.10 (e.g. fetch latest at install time or note it in a setup/deprecated section) so the time-sensitive version number does not go stale in the skill body.
Add brief error-recovery guidance for browse command failures (e.g. what to do on goto timeout or element-not-found) to close the workflow-clarity gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The browse-specific sections are lean (terse command tables and patterns, no explanation of browser concepts), but roughly 230 of ~535 lines are gstack meta-boilerplate (telemetry prompting flows, "Boil the Lake" intro, contributor mode, plan-mode footer) unrelated to browsing, and the pinned BUN_VERSION=1.3.10 is time-sensitive. This fits "mostly efficient but could be tightened"; it is not 2 because nothing explains concepts Claude already knows, and not 4 because the boilerplate volume and version pin exceed minor trimming. | 3 / 5 |
Actionability | Everything is copy-paste-ready: 11 concrete QA recipes with exact invocations (e.g. "$B fill @e3 \"user@test.com\"; $B click @e5; $B snapshot -D") and a complete command table covering navigation, interaction, inspection, and visual checks. This matches the score-5 anchor (fully executable commands covering common cases). | 5 / 5 |
Workflow Clarity | Sequencing is explicit: the SETUP check runs "BEFORE any browse command" with a stop-and-wait on NEEDS_SETUP, the handoff flow is numbered 1-2-3 with resume, and QA patterns embed verification checkpoints (snapshot -D, is visible, console, network). Score 5 is withheld because there is no error-recovery guidance when browse commands themselves fail (e.g. a goto timeout); score 3 would require broadly missing checkpoints, which is not the case. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), so everything including a ~130-line full-command API reference is inlined in one ~535-line file. Sections and tables are well-organized, matching the score-3 anchor ("content that should be separate is inline"), but not 4 since no content is split out to one-level-deep reference files, and not 2 since structure and navigation within the file are good. | 3 / 5 |
Total | 15 / 20 Passed |