Content
85%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, actionable skill body with a clear workflow and safety checks. Its only weakness is mild redundancy across sections that could be consolidated.
Suggestions
Consolidate the repeated guidance about ref staleness and preferring refs over coordinates — it appears in Requirements, Tool guidance, and Reliability rules; state each rule once in the most relevant section.
Trim the 'When to use it' bullets, which restate triggers already present in the frontmatter description, to avoid duplication.
Merge Preferred flow step 5 ('After any UI transition, snapshot again before reusing refs') with the 'snapshot -> act -> snapshot loop' reliability rule into one authoritative loop description.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean and assumes Claude's competence, but it restates ref staleness and 'prefer refs over coordinates' across the Requirements, Tool guidance, and Reliability rules sections, which could be tightened to a single statement. | 2 / 3 |
Actionability | It gives concrete, per-tool guidance with specific usage rules ('prefer interactive_only', 'use ref values from the latest snapshot', 'pass an element ref, not raw coordinates'), which is highly actionable for an instruction-only skill. | 3 / 3 |
Workflow Clarity | The numbered Preferred flow has an explicit re-snapshot checkpoint, the Reliability rules encode a snapshot->act->snapshot loop, and the Blockers section provides safety validation for destructive actions. | 3 / 3 |
Progressive Disclosure | With no bundle files present, the content is well-organized into clearly labeled sections (When to use, Requirements, Preferred flow, Tool guidance, Reliability rules, Blockers) appropriate for a simple single-purpose skill. | 3 / 3 |
Total | 11 / 12 Passed |