Content
96%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.
An exceptionally well-executed command-skill body: lean, tool-specific, copy-paste-ready, with an explicit core loop and per-error recovery guidance. The only defect is a progressive-disclosure gap where the advertised templates/*.sh starter scripts are absent from the bundle.
Suggestions
Add the templates/*.sh starter scripts to the bundle (or correct the table and the `--ref templates/form-automation.sh` example to point at files that actually ship), so every advertised load path resolves.
Consider replacing the bare `templates/*.sh` row with named template files and their use cases, mirroring the per-file "When you need" descriptions used for references/.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational throughout — session naming semantics, ref validity rules, the "Don't use wait --load networkidle as a generic SPA wait" anti-pattern, and tab-revival behavior are all non-obvious, tool-specific knowledge with no padding or explanation of concepts Claude already knows. Every token earns its place, matching the 5 anchor. | 5 / 5 |
Actionability | Commands are copy-paste ready and complete with real flags across every section — the four-step core loop, snapshot variants, the login sequence ending in `wait --url "**/dashboard"`, the quoted-heredoc `eval --stdin` extraction, and dialog handling. Even troubleshooting remediations name exact commands (e.g., `focus @e1` then `keyboard inserttext "text"`), fully matching the 5 anchor. | 5 / 5 |
Workflow Clarity | The core loop is a numbered sequence with explicit re-snapshot checkpoints after page changes, waits are tied to the expected condition rather than fixed sleeps, and the Troubleshooting section is a per-error feedback loop (symptom → cause → exact remediation → re-snapshot). Restore failures and blocked dialogs have explicit verification commands (`session info --json`, `dialog status`), satisfying the 5 anchor's explicit-validation and error-recovery criteria. | 5 / 5 |
Progressive Disclosure | The "Load more when you need it" section clearly signals all ten references with a load-path table plus a second table routing to other skills, and every listed references/*.md file exists one level deep in the bundle. It misses the 5 anchor because `templates/*.sh` and the example path `templates/form-automation.sh` are referenced but no templates directory exists in the bundle, so a signaled path does not resolve. | 4 / 5 |
Total | 19 / 20 Passed |