Content
71%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 router skill: clear operating rules, a sequenced default flow, and excellent progressive disclosure via gated reference files. The main weakness is redundancy across sections that inflates token cost without adding information.
Suggestions
Consolidate the 'plain snapshot vs snapshot -i' rule into a single statement; it currently appears in Default operating rules, Default flow, and Decision rules.
Merge the repeated 'Load bootstrap-install.md and exploration.md before acting' instruction (intro, Default flow, Required references) into one canonical location.
Deduplicate 'Prefer @ref or selector targeting over raw coordinates', which is stated in both Default operating rules and Decision rules.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The router is mostly lean and assumes Claude's competence, but several rules are repeated across sections — 'Use plain snapshot when...' (Default operating rules, Default flow, Decision rules), 'Prefer @ref or selector targeting' (twice), and the bootstrap+exploration load instruction (intro, Default flow, Required references) — which could be tightened into one statement. | 3 / 5 |
Actionability | Concrete commands and decision rules (`snapshot`, `snapshot -i`, `get`/`is`/`find`, `fill` vs `type`, `back` vs `back --system`, `--delay-ms`) give mostly executable guidance with only minor gaps, appropriate for an instruction/routing skill. | 4 / 5 |
Workflow Clarity | The numbered Default flow (open -> inspect/act -> verify -> close) gives a clear sequence with most checkpoints ('Re-snapshot after meaningful UI changes', 'verify if needed'), though a couple of validation checkpoints remain implicit rather than explicit. | 4 / 5 |
Progressive Disclosure | A concise overview routes to one-level-deep, real reference files, each with a 'When to open this file' gate; the second-level coordinate-system.md is nested only inside exploration.md, so navigation is easy and appropriately split. | 5 / 5 |
Total | 16 / 20 Passed |