Content
88%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 unusually dense, high-signal skill body: every rule encodes a non-obvious environment constraint (missing figma.create* methods, auto-flush behavior, screenshot budgets, forbidden tools) and is backed by executable patterns and a verified reference bundle with worked recipes. The only real costs are mild redundancy across sections and API surface detail inlined in the overview that the bundle's own reference files already cover.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every line is environment-specific and non-inferable ('$fig.auto-flushes at script end', 'GROUP has no fills/strokes/cornerRadius', 'up to 5 .screenshot() calls per tool call'), with no filler explaining concepts Claude already knows — better than anchor 3. It is not 5 because of repeated content: the hex helper appears twice (pattern block and Critical Rule 6), Critical Rule 9 duplicates the 'Node property gotchas' children list, and the 'componentKey from search_design_system' import point is restated three times. | 4 / 5 |
Actionability | Copy-paste-ready, complete code for every common operation — the autoLayout-with-children builder, $fig.query().set() updates, instance creation with props, gradient stops, the hex helper, page switching — plus the 'full surface' API listing. All cited reference files (fig-builder.md, critical-rules-deep.md, variable-patterns.md, plugin-api-standalone.d.ts, etc.) exist in the bundle, matching anchor 5's 'fully executable, covers the common cases'. | 5 / 5 |
Workflow Clarity | Multi-step processes are explicitly sequenced with validation checkpoints and error-recovery feedback loops: incremental placeholder+replace building with .screenshot() verification per step, the two-call variant-discovery pattern (inspect componentPropertyDefinitions, then instantiate), rehydrating variable handles across calls, and the 3-call bulk-mutation budget ending in 'FINAL REPORT... STOP'. Rule 12/15 ('unexpected error is server-side — change approach'; '3 retries → switch approach') close the retry loop, so the batch-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | The body points to a real, verified 14-file reference bundle one level deep, each entry labeled with its content ('WRONG/RIGHT examples, full node-type pitfall list', 'grep, don't read whole'), and a dedicated References section — matching anchor 4's 'good structure, references mostly clear'. It is not 5 because the '$fig create + mutate API (full surface)' section and parts of 'Node property gotchas' inline API-detail content that fig-builder.md and plugin-api-standalone.index.md already exist to carry, making the main file longer than a clean overview. | 4 / 5 |
Total | 18 / 20 Passed |