Content
81%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.
An exceptionally actionable, workflow-driven skill body: executable examples for every API it promotes, explicit validation checkpoints with feedback loops, and a well-organized one-level-deep reference bundle. Its main weakness is token efficiency — several critical rules are stated three times across rules, error tables, and checklists, and a chunk of API reference is inlined that belongs in the references directory.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious, tool-specific knowledge (atomicity, page-context resets, 0-1 colors, sizing-enum distinctions) and explains nothing Claude already knows, but it repeats material: the layoutSizing rules appear in Rules 12/12b, again in the Section 7 error table, and again in the Section 8 checklist; the page-switching rule appears in Rule 9 and twice in Section 2; Rule 15 restates Section 3. Section 11 ('Snippet examples') is vague filler. This matches anchor 3 — mostly efficient but could be tightened — rather than anchor 4, where over-explanation is only minor. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready guidance covering the common cases: `await figma.setCurrentPageAsync(page)` snippets, a dozen `node.query()` selector examples, `node.set()` batching, `figma.createAutoLayout('VERTICAL', { name: 'Column', itemSpacing: 8 })`, `await frame.screenshot({ scale: 2 })`, ready-to-run inspection scripts, and an error-message → likely-cause → fix table keyed to exact error strings. This is the anchor-5 case; anchor 4 would imply gaps in the covered cases, and there are none of consequence. | 5 / 5 |
Workflow Clarity | Section 6 gives a numbered six-step pattern (inspect → skeleton → fill → return IDs → validate → fix before moving on), a suggested step order, and a per-step table of what to validate with get_metadata vs get_screenshot; Section 7 gives an explicit STOP → read error → fix → retry feedback loop plus a self-correction table; Section 8 adds a pre-flight checklist; and the atomicity guarantee makes retry-safe validation explicit. This is exactly the anchor-5 combination of clear sequence, explicit validation, feedback loops, and checklists. | 5 / 5 |
Progressive Disclosure | The Section 10 Reference Docs table maps all 11 verified reference files to when-to-load and what-it-covers; links carry precise anchors (all spot-checked anchors exist in gotchas.md, and working-with-design-systems/wwds.md exists); the 455KB d.ts is explicitly marked grep-only. It falls short of anchor 5 because ~60 lines of query-selector syntax and QueryResult API reference are inlined in Section 5 where the skill's own pattern would put them in a reference file, and the 435-line body itself carries material (full editor-mode node-type lists) that could be externalized. It is clearly above anchor 3: the split is real and well-signaled, with only minor placement gaps. | 4 / 5 |
Total | 17 / 20 Passed |