Content
78%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 body is a highly actionable, well-organized single-file CLI reference with strong examples and error recovery. Its main weakness is the absence of progressive disclosure — substantial reference sections that could be split into bundle files are inlined, inflating token usage.
Suggestions
Move the Action Reference, Snapshot Control, and Macros sections into separate reference files (e.g. ACTIONS.md, SNAPSHOT.md, MACROS.md) and link to them one level deep from SKILL.md to reduce the inline token footprint.
Trim redundancy such as the click-wait vs click --wait-stable restatement and consolidate the snapshot-transform flag descriptions.
Add an explicit validate-before-proceed checkpoint to the Workflow Pattern (e.g. snapshot to confirm state before interacting) to strengthen workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a dense CLI reference with executable signatures and return shapes rather than concept lectures, so most tokens earn their place; minor redundancy (e.g., click-wait re-explained as click --wait-stable, lengthy snapshot-transform descriptions) could be trimmed, placing it just above the midpoint anchor. | 4 / 5 |
Actionability | Every action ships a copy-paste-ready bash invocation with full argument hints, plus a worked Workflow Pattern and an error-recovery table — fully executable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | A clear navigate → snapshot → interact → verify sequence and a MANDATORY bot-detection recovery loop provide good sequencing and feedback, but the main workflow pattern is brief and lacks an explicit validate-before-proceed checkpoint, leaving it just under the top anchor. | 4 / 5 |
Progressive Disclosure | The file is well-sectioned with clear headers, but at ~530 lines it inlines large blocks (full Action Reference, Snapshot Control, Macros) that belong in separate reference files, and there are no bundle files or one-level-deep references to offload them. | 3 / 5 |
Total | 16 / 20 Passed |