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 highly actionable, well-sequenced workflow skill with executable code, hard gates, and strong validation/feedback loops; its only real weakness is that it is long and inlines some API detail that could live in the referenced detail files, plus minor duplicated guidance.
Suggestions
Dedupe the 'search broadly, one intent per query' guidance that appears in both Step 2a-iii and Best Practices — keep it in one place and link from the other.
Move the longer discovery code blocks (2a-ii instance-walk, 2b boundVariables enumeration, 2c styles enumeration) into a referenced patterns file, keeping only a short inline example in SKILL.md.
Trim inline rationale comments like 'This is a logging parameter — it does not affect execution' where the surrounding context already conveys the point.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense with non-obvious API gotchas and executable code rather than padding about what Figma/libraries are, but it is long (~470 lines) with some duplicated guidance ('search broadly, one intent per query' appears in both 2a-iii and Best Practices) and a few minor rationale comments that could be trimmed. | 4 / 5 |
Actionability | Provides copy-paste-ready use_figma scripts for every phase (component discovery, variable/style binding, wrapper creation, section building, icon SVG import, font verification, image transfer) with concrete API calls and only parameter placeholders to substitute. | 5 / 5 |
Workflow Clarity | A 'Required Workflow' with ordered Steps 1–6, hard gates ('Do not skip steps', explicit forbidden shortcuts), and explicit validation checkpoints (get_screenshot after each section, Step 5 full-view validation, mandatory font assertion) plus validate→fix→re-validate feedback loops. | 5 / 5 |
Progressive Disclosure | SKILL.md acts as an overview with well-signaled one-level-deep references to two real local files (componentization.md, discover-product-font.md with anchors) and a clear Reference Docs section pointing to figma-use detail files; however a fair amount of API detail (2a-ii, 2b, 2c code blocks) remains inlined rather than split out. | 4 / 5 |
Total | 18 / 20 Passed |