Content
73%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.
This is a dense, operationally excellent skill body: a clearly sequenced workflow with validation and consent gates exactly at the risky points, and copy-paste code for the shared runner. Its weaknesses are verbosity (historical asides, an unversioned known-warts list, restated guidance) and heavy reliance on provider docs that are not present in this bundle, which caps both actionability and progressive disclosure.
Suggestions
Conciseness: move the version-pinned browser-use wart list ("0.12.9 … flaky per-step client-auth race … AgentOutput validation error") into a 'Known issues' section in the relevant provider doc or a reference file, and cut asides like the BROWSE_LAB_* naming history that don't change what Claude does.
Actionability: include a minimal inline create/CDP_URL example (or ensure the providers/ docs ship with the bundle) so the core 'Create the browser' step is executable from the skill as distributed, rather than a pointer to files not present.
Progressive disclosure: move the ~100 lines of embedded Python (browse-runner.py and browse-nav.py heredocs) into scripts/ files the skill invokes, keeping SKILL.md as the lean overview the structure already aims for.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — nearly every paragraph carries non-obvious operational knowledge (keychain semantics, profile-as-credential rules, provider quirks) that Claude cannot know — but it could be tightened: asides like "the `BROWSE_LAB_*` names are historical — they predate this skill becoming the default", "(the printed copy is for your eyes…)", and restating the browse-vs-curl guidance already in the description pad the text. The unpinned version-specific wart list ("Browser-use 0.12.9 has two known warts") is time-sensitive detail not placed in a known-issues/deprecated section, which the guidelines say should penalize conciseness, keeping this at 3 rather than 4. | 3 / 5 |
Actionability | Highly concrete where it speaks: a copy-paste runner script, `sh "<skill dir>/install-runtime.sh"`, exact keychain curl calls, the wall-URL extraction one-liner, and the nav script all match the 'mostly executable' to 'fully executable' anchors. It stops short of 5 because the single most important steps — creating and deleting the browser — are delegated to provider docs ("Follow your provider doc's 'Create the browser' section") that are not present in this bundle, and the runner depends on `PROFILE_ENV`/`PROFILE_SERVICE` values defined only in those absent docs. | 4 / 5 |
Workflow Clarity | The sequence is explicit and well-checkpointed: pick provider → prerequisites (check env first, credential-exists check before bootstrap) → 1. Create → 2. Run → 3. Clean up → Reporting, with validation gates exactly where risk lives: pre-launch spending consent ("the consent moment is BEFORE launch… write the authorization INTO the task text"), sanity-checking the wall URL against the task domain (prompt-injection defense), account-ownership confirmation before acting, and feedback loops for recovery (relaunch-and-rerun after sign-in, retry once on the flaky auth race, raise BROWSE_LAB_MAX_STEPS on malformed-step retries). This matches the 5 anchor's 'explicit validation steps; feedback loops for error recovery'. | 5 / 5 |
Progressive Disclosure | Good structure with a sound split: provider-specific detail pushed to one-level-deep, clearly signaled references ("Read `providers/kernel.md`", "Read the provider doc BEFORE creating anything") while shared logic (runner, keychain, spending, reporting) stays inline — matching the 4 anchor. Not 5: the referenced files (four provider docs, install-runtime.sh) are absent from the bundle so navigation cannot be verified, and ~100 lines of Python (runner + nav script) plus the multi-step keychain ask/drop flow are inlined in SKILL.md where a scripts/ or reference file would keep the overview leaner. | 4 / 5 |
Total | 16 / 20 Passed |