Content
72%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is concise and well-organized with executable install/config commands, but it stops short of demonstrating the skill's central purpose — the actual browser-automation workflow is deferred to `--help`, leaving the primary task under-specified. Progressive disclosure is fine for a skill this small with no bundle files.
Suggestions
Add one minimal executable example showing the core automation task (e.g., a sample `dev-browser` script or command that navigates and extracts/screenshot), so the primary workflow is copy-paste-ready rather than deferred to `--help`.
Provide a short numbered usage workflow (launch/connect -> run script -> read result) so the main multi-step flow is sequenced explicitly in the body.
Clarify how sandboxed JavaScript scripts are authored and passed to the CLI, since the body mentions the mechanism but never shows it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — an install block, a "Run `dev-browser --help`" pointer, and one dense idle-timeout paragraph ("--idle-timeout 5m closes each launched browser after inactivity while preserving its profile and login state") — with no padding explaining concepts Claude already knows. It is not score 2 because nothing reads as unnecessary or tighten-able. | 3 / 3 |
Actionability | Concrete commands exist ("npm install -g dev-browser", "dev-browser install", "--idle-timeout 5m", "--idle-timeout 0"), but the core browser-automation workflow is deferred to "Run `dev-browser --help` to learn more" with no example script or command for actually controlling a browser. This matches score 2 (some concrete guidance but missing key details), falling short of score 3's copy-paste-ready bar for the primary task. | 2 / 3 |
Workflow Clarity | Install steps are clear, but the main task — controlling browsers with sandboxed JavaScript scripts — is not sequenced or demonstrated; usage is pushed to `--help`. This fits score 2 (sequence present but the primary workflow is implicit/deferred) rather than score 1 (install steps are present) or score 3 (the main workflow is not laid out). | 2 / 3 |
Progressive Disclosure | The skill is under 50 lines with no bundle files in references/, scripts/, or assets/, and the body is organized into clear Installation and Usage sections. Per the simple-skills scoring note, well-organized sections alone earn score 3 here. It is not score 2 because there is no inline content that should be split off and no nested referencing. | 3 / 3 |
Total | 10 / 12 Passed |