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.
The body is highly actionable with a well-sequenced, validated workflow and good progressive disclosure to real reference files. Its main weakness is redundancy: the Best Practices section repeats guidance already embedded in the workflow steps.
Suggestions
Cut or fold the 'Best Practices' section into the corresponding workflow steps — most bullets ('Always search before building', 'Search broadly one intent per query', 'Componentize by default', 'Work section by section', 'Validate visually') restate rules already stated inline.
Move the longer discovery scripts (2b variable enumeration, 2c style enumeration) into a reference file and link to them, keeping only the canonical example inline to reduce SKILL.md length.
Tighten the 'Parallel Workflow with generate_figma_design' preamble by leading with the one-line rule and the image-transfer mandate, then the steps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most content is specialized Figma Plugin API knowledge Claude would not reliably know, but the 'Best Practices' section largely restates rules already given in the workflow steps ('Always search before building', 'Search broadly one intent per query', 'Componentize by default', 'Work section by section'), and the parallel-workflow preamble could be tightened. | 3 / 5 |
Actionability | Provides copy-paste-ready executable code for the common cases — component key resolution, variable/style binding and import, setProperties text overrides, SVG icon import, image-hash transfer, and existing-button variant swaps — covering the realistic scenarios. | 5 / 5 |
Workflow Clarity | A clear 6-step sequence with explicit validation checkpoints (get_screenshot per section, font-family assertion), hard-gate 'Forbidden' shortcuts gating mutation, and a STOP/inspect/fix/retry error-recovery feedback loop for the batch, section-by-section canvas operations. | 5 / 5 |
Progressive Disclosure | Well-signaled one-level-deep references to real local files (references/componentization.md, references/discover-product-font.md) and a labeled 'Reference Docs' index to figma-use references; minor gaps where some inline discovery scripts could live in references. | 4 / 5 |
Total | 17 / 20 Passed |