Content
100%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 lean, fully executable verification skill: concrete shell commands with quantified pass criteria, per-workflow preconditions and failure-recovery loops, and an appropriate split between the overview body, reference checklists, and script helpers. It assumes Claude's competence throughout and adds only what Claude could not know about this codebase and tooling.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~80-line body contains only project-specific operational knowledge (e.g., 'Protocol landscape names are opposite CoreDevice physical names; the inner panel also has a rotated natural axis', 'Safari's cover UI excludes upside-down portrait') with no explanations of concepts Claude already knows; every sentence carries a command, constraint, or non-obvious fact. | 5 / 5 |
Actionability | Commands are copy-paste ready ('node packages/serve-sim/dist/serve-sim.js fold 180 -d <udid>', 'xcrun devicectl device motion hinge-angle --device <udid> --timeout 5') with the placeholder convention stated up front ('Use the actual server port and Duo UDID in subsequent commands'), and pass criteria are quantified ('Marker centers must land within two output pixels of their rendered centers; hardware anchors must land on opaque model pixels'). | 5 / 5 |
Workflow Clarity | Each workflow is sequenced with preconditions (rebuild then restart the server; 'Bring Safari to the foreground on the Duo before running'), explicit validation ('Compare the preview's selected display with the latest SpringBoard DisplayContentMode event containing .cover:pri or .inner:pri'), and a feedback loop ('Stop on a failed assertion and inspect the reported physical, UI, and model orientations before retrying'), matching the top anchor's validate-inspect-retry pattern. | 5 / 5 |
Progressive Disclosure | The body stays an operational overview and pushes the 218-line feature checklist to references/expected-behavior.md and historical results to references/verification.md — both real files, clearly signaled with in-context links, exactly one level deep — while executable helpers live in scripts/; nothing that belongs in a reference is inlined and navigation is easy. | 5 / 5 |
Total | 20 / 20 Passed |