Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable and well-structured, with a clear multi-step workflow, validation checkpoints, error-recovery feedback loops, and a clean progressive-disclosure reference table. Its only weakness is repetition of a few key rules across sections, which inflates the token budget without adding new information.
Suggestions
Consolidate the `setCurrentPageAsync` rule so it is stated once in Page Rules and only referenced (not restated) from the Critical Rules list, the error table, and the Pre-Flight Checklist.
Apply the same single-source treatment to the canonical font-load recipe and the layoutSizing value rules to reduce cross-section redundancy.
Consider trimming or collapsing Rules 12/12a/12b into one rule plus a gotchas link, since the error table and checklist already restate the failure messages.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with genuinely non-obvious environment-specific gotchas, but several rules are repeated across multiple locations — the `setCurrentPageAsync` rule appears in Critical Rules, Page Rules, the error table, and the checklist; the font-load recipe and layoutSizing rules are likewise restated — which keeps it just below 'every token earns its place'. | 2 / 3 |
Actionability | It provides abundant executable, copy-paste-ready code (e.g. `figma.currentPage.query('FRAME[name^=Card] TEXT').set({...})`, `await figma.setCurrentPageAsync(targetPage)`, `findAllWithCriteria({types:[...]})`) with concrete selectors, property values, and a canonical recipe. | 3 / 3 |
Workflow Clarity | The incremental workflow is clearly sequenced (Inspect → skeleton → fill → return IDs → validate → fix) with explicit validation checkpoints per step, a Pre-Flight Checklist, and a full error-recovery feedback loop (stop → read error → fix → retry). | 3 / 3 |
Progressive Disclosure | The body is an overview that points to a well-organized one-level-deep `references/` set (11 docs plus the wwds subfolder) via a clear Reference Docs table mapping each doc to when-to-load and coverage; all referenced paths were verified to exist. | 3 / 3 |
Total | 11 / 12 Passed |