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.
Highly actionable, backend-specific operational guidance with executable JSON examples, a clear fallback workflow, explicit error-recovery loops, and screenshot verification. It is lean and well-organized, with only minor redundancy and structural interleaving keeping it from top marks.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with backend-contract details Claude cannot know otherwise and contains no concept explanations or padding; minor trimmable instances remain, e.g. the path-freshness rule stated twice ('Use a `path` returned by the latest `uia_snapshot` only while the UI is unchanged' vs. 'take a fresh `uia_snapshot` before reusing a path') and a 10-item feature list that partially duplicates the loop guidance. | 4 / 5 |
Actionability | Fully executable guidance: copy-paste-ready JSON payloads for element_action, uia_snapshot, and uia_action; exact tool and action names; enumerated operations with per-operation preconditions; and exact error codes to stop on. | 5 / 5 |
Workflow Clarity | A numbered preferred loop (list_windows, get_window_state, element_action, foreground fallback) with explicit error-recovery feedback loops (ambiguity, take a fresh snapshot and narrow the target; missing target, take a fresh snapshot before coordinates), stop-and-ask handling for session error codes, and mandatory screenshot verification after state-changing actions. | 5 / 5 |
Progressive Disclosure | The skill is self-contained with no bundle files and well-sectioned headers (UIA Targeting, Session Caveats, Geometry), so nothing is buried; minor gap: the newer element_action loop and the legacy uia_snapshot/uia_action material are interleaved within one large 'Windows UIA Targeting' section rather than clearly separated. | 4 / 5 |
Total | 18 / 20 Passed |