Content
82%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, highly actionable skill body: concrete tool contract, executable example, and a decision-tree workflow with a user-checkpoint for ambiguous plan selection. The only weaknesses are minor — a redundant restatement of argument defaults, repeated mandatory framing, and no error-path guidance for failed lookups.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — a parameter table, a JSON example, and a short decision tree with no explanations of concepts Claude already knows. Not level 5 because the mandatory preamble repeats the frontmatter's enforcement language, and the paragraph 'Parse the arguments from the skill invocation. If editorType is not provided, default to design...' restates the defaults already given in the bullet list above it. | 4 / 5 |
Actionability | Fully executable guidance: exact tool name, parameter table with required flags, a copy-paste-ready JSON call example, the tool's return fields (file_key, file_url), and the explicit next step ('Use the file_key for subsequent tool calls like use_figma'). Nothing is pseudocode or vague; not lower on any anchor. | 5 / 5 |
Workflow Clarity | A clear three-step sequence with a planKey decision tree that handles the ambiguous multiple-plans case by asking the user — a real checkpoint. Not level 5 because there are no explicit validation or error-recovery steps (e.g. what to do if whoami returns an empty plans array or the tool call fails), and the anchor-5 example includes feedback loops. | 4 / 5 |
Progressive Disclosure | Well-organized single-file skill: sections are clear, and the slides edge-case detail is appropriately deferred via a clearly signaled one-level reference ('See [figma-use-slides → slide-grid](../figma-use-slides/references/slide-grid.md)'). Not level 5 because the body is ~73 lines rather than under 50, and the sole reference points into a sibling skill's bundle rather than this skill's own, which is slightly unusual navigation though functional. | 4 / 5 |
Total | 17 / 20 Passed |