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.
An unusually dense, operational skill body: concrete commands, named APIs, and validation-gated workflows for both directions of the Figma sync, with no filler. The only structural improvement would be moving the Figma push API detail into a reference file and adding a worked example script.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient with zero padding: every line carries repo-specific facts Claude cannot know (the file key "oJQ7t9q4e8oHzLZKuki7k1", "only slots accept appendChild on an instance", "new nodes land on the current page, which may be the cover"). It assumes Claude's competence and never explains concepts it already knows, matching the score-5 anchor. | 5 / 5 |
Actionability | Concrete and mostly executable: real commands ("node prototypes/kit/build.ts <name>", the Playwright pnpm path) and named API calls ("setCurrentPageAsync", "importComponentSetByKeyAsync", "figma.variables.setBoundVariableForPaint"). Not 5 because the Figma push flow lacks a copy-paste-ready example script for the common case — guidance is procedural rather than executable end-to-end. | 4 / 5 |
Workflow Clarity | Both edit/republish and Figma-pull are numbered sequences with explicit validation checkpoints ("Zero page and console errors, and look at a screenshot of what changed"; "screenshot the section with get_screenshot, and fix what's off") and error-recovery loops ("A failed script rolls back, so re-read before retrying"). The destructive/batch operations (republish, commit and push) are all gated behind verification, matching the score-5 anchor. | 5 / 5 |
Progressive Disclosure | Well-signaled one-level-deep references ("prototypes/README.md is the index... Read it first", "<name>/changes.json", "<name>/prototype.json", "kit/add-icons.ts") and clear section structure. Not 5: the Figma push detail (~15 lines of component/color/API-call rules) sits inline where a reference file would fit, a minor organization gap matching the score-4 anchor rather than a fully split structure. | 4 / 5 |
Total | 18 / 20 Passed |