Content
85%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 well-structured instruction-only skill body: an explicit ordered flow with a truncation recovery loop and validation gate, concrete tool names, and clean one-level-deep references to real bundle files. Only minor duplication and slightly vague asset-download guidance keep conciseness and actionability at 4.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean, directive body with no background exposition Claude already knows, but with minor duplication that could be trimmed: flow step 6 ('Validate against Figma for 1:1 look and behavior before marking complete') repeats the implementation-rules bullet ('Validate the final UI against the Figma screenshot for both look and behavior'), and the link-based prompting section restates usage reminders also in references/figma-mcp-config.md. Anchor 4, not 5, because of these trimmable repetitions. | 4 / 5 |
Actionability | Concrete, executable guidance naming the exact tools in order (get_design_context, get_metadata, get_screenshot) with a truncation fallback; as an instruction-only skill, absence of code is not penalized. Not 5 because 'download any assets needed' and the 'assets endpoint' are left vague compared to the fully specified tool calls. | 4 / 5 |
Workflow Clarity | 'Required flow (do not skip)' gives a clear 6-step sequence with an explicit conditional recovery branch (truncated response -> get_metadata -> re-fetch only required nodes) and an explicit validation gate ('Validate against Figma for 1:1 look and behavior before marking complete'). Not a destructive/batch operation, so the cap does not apply; matches anchor 5. | 5 / 5 |
Progressive Disclosure | The body is a well-organized ~42-line overview; setup/troubleshooting is appropriately split to references/figma-mcp-config.md and the tool catalog to references/figma-tools-and-prompts.md, both real files one level deep and clearly signaled in the References section with one-line descriptions. Matches anchor 5. | 5 / 5 |
Total | 18 / 20 Passed |