Content
86%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 tight, well-structured workflow document: a decision table and exact tool names make it highly actionable, and the short length keeps it token-efficient. The main gaps are a triple-repeated clarification rule and validation/error-recovery detail deferred to the tool response rather than stated inline.
Suggestions
Consolidate the output-clarification rule into one place (the decision table's first row already encodes it) to remove the repetition across the opening paragraph and section 1 intro.
Inline one concrete example of validating locally before upload (e.g., the typical validate step send_code_to_figma returns) so the validation checkpoint is explicit rather than delegated to the tool response.
Clarify what "setup recovery" involves in section 2 — currently it only names the scenario without a recovery loop the reader can follow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational with no concept explanations Claude already knows, so it is well above anchor 3. However, the ask-when-output-is-unclear rule is stated three times (opening paragraph, "If the output is unclear, ask the user before proceeding", and the table row "Ask 'Editable design layers or a code layer?' and end your turn"), which fits anchor 4's "minor instances that could be trimmed" rather than anchor 5's "every token earns its place". | 4 / 5 |
Actionability | Fully actionable for an instruction-only skill: exact tool calls (generate_figma_design, html_to_figma, send_code_to_figma, whoami, create_new_file), a concrete gate (whoami.code_layers_enabled), a measurable heuristic ("fewer than 10 or unknown → Code Layer; 10 or more → standalone"), the exact question to ask the user, and a complete decision table covering the common input/output combinations. Absence of code is not penalized per the scoring notes. | 5 / 5 |
Workflow Clarity | The two-stage sequence (choose output/destination → follow the import response) is clear, with real checkpoints: ask before proceeding, whoami gate before choosing a Code Layer, "preserve the app and validate locally before uploading when instructed", and "do not describe an unconfirmed stage as complete". It falls short of anchor 5 because validation and error-recovery mechanics are largely delegated to the tool's returned nextStep rather than given as explicit inline validate/fix/retry steps. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, needs no external reference files (none exist in references/, scripts/, or assets/), and is cleanly organized into an intro plus two numbered sections. Per the guideline that under-50-line skills with no need for external references can score 5 with well-organized sections, this is the best fit. | 5 / 5 |
Total | 18 / 20 Passed |