Content
82%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.
A highly actionable, well-organized command reference with essentially no padding. The main improvement opportunities are removing duplicate examples between Quick Start and later sections, adding state verification to the fixed-delay patterns, and offloading exhaustive flag/keycode reference material to a separate file.
Suggestions
Trim duplicate examples: the tap and gesture examples in Quick Start repeat verbatim in Touch & Gestures and Gesture Presets — keep Quick Start to one command per capability.
Add verification to the timing-based patterns: replace fixed --pre-delay waits in wait-then-tap and form-filling with a describe-ui check confirming the target element is present before tapping/typing.
Move exhaustive reference material (HID keycode table, full flag documentation for swipe/record-video) into a references/ file and link it from SKILL.md to keep the main file a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is almost entirely executable commands with terse comments and no concept explanations Claude already knows. Minor duplication (e.g., "axe tap -x 100 -y 200" and "gesture scroll-down" appear in both Quick Start and their dedicated sections) keeps it just below the lean 5 anchor. | 4 / 5 |
Actionability | Every example is copy-paste-ready bash with real flags (e.g., "echo \"Complex text\" | axe type --stdin --udid $UDID", the keycode sequences, the ffmpeg pipe), and the Automation Patterns section covers the common multi-step cases. Fully executable guidance. | 5 / 5 |
Workflow Clarity | Sequences are clear and the scroll-to-find pattern includes an explicit validation checkpoint ("grep -q \"targetElement\" && break"), but the form-filling and wait-then-tap patterns rely on fixed delays without verifying UI state first — minor validation gaps fitting anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | Well-organized single-file structure with eight logical sections and a preset table, appropriate for a single-binary CLI with no bundle files. At ~170 lines, exhaustive reference material (HID keycode tables, full flag documentation) could be split into a references/ file, so it fits anchor 4 rather than 5. | 4 / 5 |
Total | 17 / 20 Passed |