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 exemplary dense, operational skill body: exact commands, named library functions, explicit validation thresholds with feedback loops, and no padding or concept explanations. The remaining gaps are small — a few connector-mediated steps cannot be made executable, and progressive disclosure relies on one script plus an out-of-bundle relative path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body never explains what Figma is or how the tooling works conceptually; every sentence carries operational load (e.g. 'Every import happens at build time and freezes a local file with its source recorded under `.media/`, so renders never call Figma and re-running a command re-imports only what changed'). At ~51 lines covering six workflows, every token earns its place. | 5 / 5 |
Actionability | The main flows are copy-paste ready — `npx hyperframes figma asset '<url or fileKey:nodeId>' [more refs] --format svg|png --scale 2 --description "<what it is>"`, `motionContextToDocs(raw, { selectorFor, repeat })`, `node <SKILL_DIR>/scripts/verify-motion.mjs --reference <export.mp4> --render <render.mp4> --crop WxH+X+Y` — but the connector-based fetch ('Fetch motion context for the parent frame in one recursive request') and the shader native-export step have no executable command, leaving minor gaps versus the fully-executable anchor 5. | 4 / 5 |
Workflow Clarity | The motion pipeline is a numbered sequence with an explicit validation gate and feedback loop ('fails under 15 dB ... A fail means fix the translation, not the threshold') plus a fallback for untranslatable tracks, and the component flow has error recovery ('an unknown token stays a literal marked `data-figma-unresolved`: import that library's tokens and re-import') alongside a hero-drift pixel check and a 401/403/429 error-remediation table. This matches the anchor-5 validate→fix→retry pattern; the storyboard section's lack of a verify step is the only gap, and it has explicit failure-mode and fallback rules instead. | 5 / 5 |
Progressive Disclosure | Good structure: six clearly headed sections, and the one bundle reference (`scripts/verify-motion.mjs`) is real, one level deep, and invoked with its exact CLI. However the body also leans on an external conditional path (`../hyperframes/references/plugin-installation.md`) outside the skill's own bundle, and the dense storyboard/motion detail is all inlined with no further splitting — minor organization gaps versus the cleanly-split anchor 5. | 4 / 5 |
Total | 18 / 20 Passed |