Content
92%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.
An exemplary lean skill body: token-efficient tables, a concrete tool inventory, and a workflow with explicit acceptance thresholds and a genuine feedback loop. The only weaknesses are minor actionability gaps — a dangling cross-reference to the frontend-design skill and an unspecified DOM-comparison method.
Suggestions
Resolve the dangling reference "the **frontend-design** skill" by either giving its path or inlining the one or two token rules it should contribute.
In the verification step, state how to compare DOM bounding boxes against node metrics (e.g., which browser/DevTools command or script to use), making step 5 fully executable.
Consider one short example of a rendered tool call (URL with node-id) so the MCP invocation format is copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and dense: two compact tables, a numbered workflow, and a short mappings section, with no explanation of concepts Claude already knows (no "what is Figma", no library tutorials). Every sentence carries operational information — e.g., "It does not see what is selected in the desktop app — that is the desktop server's feature" is a useful disambiguation, not padding. | 5 / 5 |
Actionability | Concrete guidance throughout: named MCP tools with use cases, the link/node-id call convention ("pass the Figma URL of the frame or layer, including its node-id"), target file paths ("src/styles/tokens.css"), and quantified acceptance criteria ("spacing within 4px, token colors exact"). Not a 5 because two minor gaps exist: the opening cross-reference to the "frontend-design" skill is dangling (no path or pointer to its location), and step 5's "compare DOM bounding boxes against the node metrics" does not say how to perform that comparison. | 4 / 5 |
Workflow Clarity | The workflow is a clear 6-step sequence with an explicit verification step, quantified acceptance criteria ("spacing within 4px, token colors exact, font family and weight exact"), and a true feedback loop: "Outside threshold → fix the token mapping or ask design; re-run from step 2." This matches the anchor-5 example pattern (validate → fix → retry) exactly. | 5 / 5 |
Progressive Disclosure | The body is roughly 40 lines with no bundle files, and per the rubric's simple-skill guideline a short, self-contained skill with well-organized sections scores 5. Sections (MCP tools, Workflow, mappings) are clearly headed, and the two external pointers (Figma docs URL, the frontend-design skill) are one level deep, not nested. | 5 / 5 |
Total | 19 / 20 Passed |