Content
88%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 excellent, execution-focused skill body: fully executable commands, a Look→Act→Verify loop with explicit re-verification guidance, and proper offloading of full CLI syntax to a one-level-deep reference file. The only weaknesses are mild redundancy (Providers table vs. Setup block; Quick Reference table vs. the reference file) and the reference link being placed only at the end.
Suggestions
Drop the Providers table (or the Setup connect block) — both list the same four `cua do switch` targets verbatim.
Move the `references/command-reference.md` link up near the Quick Reference section header (e.g., "Full argument syntax: see command-reference.md") instead of leaving it only as the last line of the file.
Trim the Quick Reference table to the commands not fully shown in the scenarios, leaving exhaustive argument syntax to the reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and command-driven with no concept explanations Claude already knows — every section is a code block or table. Minor duplication keeps it off score 5: the Providers table repeats the four `cua do switch` variants already shown in Setup, and the Quick Reference table overlaps the separate command-reference.md. Not score 3: there is no unnecessary explanation or padding, only redundant structure. | 4 / 5 |
Actionability | Every example is a copy-paste-ready shell command with concrete coordinates ("cua do click 450 280", "cua do type 'Jane Doe'") covering the common cases: clicking, form filling, file-upload dialogs, zoom for precision, drag-and-drop, and fuzzing. This matches the score-5 anchor (fully executable, covers common cases); not score 4: there are no gaps in executable detail. | 5 / 5 |
Workflow Clarity | The core loop is explicit — "Look → Act → Verify: repeat until done" — with built-in validation (screenshot after every action) and error-recovery feedback: "Re-screenshot after every UI change: coordinates go stale when the screen changes" and "Use `zoom` any time click accuracy is uncertain". This matches the score-5 anchor (clear sequence, explicit validation, feedback loops); not score 4: checkpoints are explicit throughout, not merely implied. | 5 / 5 |
Progressive Disclosure | Good structure: workflow and common scenarios live in SKILL.md while full argument syntax is correctly split into the real, one-level-deep references/command-reference.md, signaled via a clear link. Minor gaps keep it at 4: the link to the reference file appears only at the very bottom (buried after two tables), and the 20-row Quick Reference table partially duplicates the reference file's content — the anchor-4 pattern of "most content appropriately placed; minor organization gaps". Not score 3: the split is appropriate and the reference is clearly signaled, not buried or multi-level. | 4 / 5 |
Total | 18 / 20 Passed |