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.
A high-quality workflow skill body: fully executable code at every step, hard-gated sequencing with per-section visual validation and an explicit error-recovery loop, and appropriate offloading of detail to real, clearly-labeled reference files. Its main costs are repeated emphasis of the same mandates (parallel capture, font assertion) and some long inline sections that could live in references.
Suggestions
Consolidate the parallel generate_figma_design capture mandate into one authoritative section and cross-reference it from Step 1 and Step 5 instead of restating the requirement three times.
State the font-family identification and assertion requirement once (Step 1 / Step 5) and drop the third restatement in Best Practices, keeping only a one-line pointer.
Move the icon SVG-import section and the image-transfer scripts into a reference file (e.g., references/icons-and-images.md) and link to them, slimming the Step 4/Step 5 inline content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious operational knowledge (imageHash-only image fills, getLocalVariableCollectionsAsync being local-only, createNodeFromSvg width/height sizing) and contains no beginner-concept padding — matching the level-4 anchor of efficient with minor trimmable instances. Not 5 because key mandates are repeated verbatim in multiple places: the parallel generate_figma_design capture requirement appears in its own section plus Step 1 item 5 plus Step 5, and the font-family assertion appears in Step 1, Step 5, and Best Practices. | 4 / 5 |
Actionability | Every step ships executable JavaScript for the Figma plugin API — component-key resolution from Code Connect URLs, bound-variable enumeration, wrapper sizing by container type with concrete dimensions, setProperties() text overrides, createNodeFromSvg icon import with the viewBox/width/height requirement — plus concrete search-term lists and parsing rules (hyphens to colons). This matches the level-5 anchor: copy-paste-ready code covering the common cases. | 5 / 5 |
Workflow Clarity | Steps 1–6 are explicitly ordered ('Follow these steps in order. Do not skip steps.') with hard gates forbidding premature canvas mutation, per-section get_screenshot validation with a defect checklist (cropped text, overlaps, placeholder text, wrong font, blank images), and a STOP→read→inspect→fix→retry error-recovery loop noting script atomicity. This is the level-5 anchor: clear sequence, explicit validation, feedback loops. | 5 / 5 |
Progressive Disclosure | The core workflow lives in SKILL.md with detail delegated to clearly-signaled one-level-deep references — references/componentization.md and references/discover-product-font.md both exist in the bundle, and the Reference Docs section annotates each ../figma-use reference with its content. This matches the level-4 anchor (good structure, most content appropriately placed, minor gaps): the icon-SVG-import section and the image-transfer scripts are substantial inline content that could be split out, and heavy reliance on a sibling skill's references outside this bundle is a small navigation risk. | 4 / 5 |
Total | 18 / 20 Passed |