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 high-quality orchestration body: scope-locked workflows with explicit validation and recovery loops, copy-paste-ready API specifics, and clean one-level-deep disclosure into real reference and script files. The only weakness is redundancy — the batching/validation cadence and scope-guard rules are each stated twice in near-verbatim form.
Suggestions
State the evidence-based validation cadence once (§1) and have §3 rule 12 reference it instead of restating it nearly verbatim, saving several lines without losing the rule.
Consolidate the repeated 'stop at scope boundary' guidance (§1 scope table, §1 definition of done, and §2 per-path 'then stop' notes) into a single authoritative statement.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and prescriptive — no tutorial padding or explanation of concepts Claude already knows — but the batching/validation cadence rules appear nearly verbatim in both §1 ("Use structural evidence returned by writes... Take one visual review per coherent composition phase and one post-fix screenshot only after a targeted visual fix") and §3 rule 12, and the scope-guard/stop guidance is restated across §1 and §2. Between anchors 3 and 4, noticeably above the midpoint: the redundancy is duplication of operational rules rather than unnecessary explanation. | 4 / 5 |
Actionability | Fully executable specifics throughout: exact code syntax format `var(--color-bg-primary)`, scope constants (`FRAME_FILL, SHAPE_FILL`, `TEXT_FILL`, `GAP`, `CORNER_RADIUS`), copy-paste lookup expressions (`getLocalTextStyles().find(s => s.name === name)`, `figma.variables.getVariableByIdAsync(id)`), a concrete state-file path, a ledger JSON example, real `get_libraries`/`search_design_system` call signatures with parameter shapes, and a table mapping 8 real helper scripts to purposes. Matches anchor 5. | 5 / 5 |
Workflow Clarity | Each of the four scopes has a numbered step sequence with explicit validation steps ("Validate counts, mode values, aliases, scopes, syntax, styles"), a pre-mutation scope-and-acceptance checklist, a Definition of Done checklist, idempotency checks, a resume protocol, and feedback loops ("If a required acceptance check fails, fix the scoped defect before continuing", targeted-retry splits, the `safeToRetryWithoutCanvasRead` anti-pattern). Matches anchor 5 including checklists and error-recovery loops. | 5 / 5 |
Progressive Disclosure | SKILL.md is a navigation-ready overview: §10 gives a "Load when" table for all 7 references and §11 a purpose table for all 8 scripts — every referenced path exists in the bundle, references are one level deep, and the body explicitly instructs loading references on demand ("Read references on demand; do not infer their contents from the filename"; "Load only references needed for the selected path"). Matches anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |