Content
90%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 well-structured, executable CLI reference that is lean and highly actionable, with useful automation patterns; it loses a little on workflow validation and on progressive disclosure since everything lives in one file with no external references.
Suggestions
Add an explicit validation/verification checkpoint to the form-filling and screenshot-after-action patterns (e.g. assert the expected element appears via describe-ui before proceeding) to lift workflow clarity.
Since the file exceeds 50 lines, consider moving the full Gesture Presets table and/or per-flag reference into a references/ file and signaling it from SKILL.md to demonstrate one-level-deep progressive disclosure.
De-duplicate the Quick Start tap/type/gesture examples against the dedicated sections, or trim Quick Start to a single end-to-end example, to remove minor token redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and almost entirely executable code with terse section intros; it assumes Claude's competence and avoids explaining what a simulator or HID is, though the Quick Start slightly duplicates commands detailed later. | 5 / 5 |
Actionability | Commands are copy-paste ready with real flags and values (e.g. 'axe swipe --start-x 100 --start-y 300 --end-x 300 --end-y 100 --udid $UDID') and cover the common cases comprehensively. | 5 / 5 |
Workflow Clarity | The Automation Patterns section sequences multi-step recipes and the scroll-to-find loop has a checkpoint, but most patterns (form filling, screenshot-after-action) lack explicit validation/error-recovery steps, so it sits below the 5-anchor. | 4 / 5 |
Progressive Disclosure | Content is well-organized into clearly headed sections in a single file with no bundle files present; it exceeds the simple-skill (<50 line) exception yet has no references to signal, placing it just below the well-signaled-references 5-anchor. | 4 / 5 |
Total | 18 / 20 Passed |