Content
92%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 strong, highly actionable body: complete JSON tool-call examples, explicit sequencing with error-recovery branches, and mandatory screenshot-verification checkpoints. The only notable weakness is mild redundancy — the "verify via the attached screenshot" guidance is repeated across three sections and could be consolidated once.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with backend-specific, non-obvious facts (feature names, dispatch semantics, error codes) and mostly assumes Claude's competence, but the screenshot-verification rule is stated three times ("Use it to choose an element, not as final visual proof"; "AX actions are attempts, not proof... inspect that image"; "Treat these as attempts. After any hide or minimize shortcut, inspect the fresh screenshot"), and widely known shortcuts like Command+H/M add minor padding. Not 3, since no genuinely new-to-Claude concepts are over-explained; not 5 due to the repeated verification admonitions. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready JSON tool-call payloads are given for `element_action`, `ax_snapshot`, and `ax_action`, with a concrete operation list (press/focus/set_value) and specific error-recovery branches ("If an action reports ambiguity, take a fresh snapshot and narrow the target with role plus title/description/identifier") and an exact remediation command (`/computer-use on`). The common cases are covered by concrete examples. | 5 / 5 |
Workflow Clarity | Sequences are explicit ("list_windows -> get_window_state -> element_action") with clearly defined fallback flows, and validation checkpoints plus feedback loops are present: verify via the attached screenshot "before saying the requested outcome happened", re-snapshot on ambiguity or missing target, and stop-and-ask on permission failure codes. Not 4, because error-recovery loops and verification steps are explicit rather than merely implied. | 5 / 5 |
Progressive Disclosure | No bundle files (references/, scripts/, assets/) exist, and this ~100-line skill is self-contained and appropriately so: everything is organized under three well-labeled sections (macOS AX Targeting, macOS Window Actions, Permissions) with nothing inlined that clearly belongs in a separate file. Not 4, since there are no organization gaps — content placement and navigation are clean. | 5 / 5 |
Total | 19 / 20 Passed |