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.
A highly actionable, well-sequenced skill body with concrete commands, named helpers, and strong validation/feedback loops across all phases. It is dense and mostly lean, with only minor verbosity and a few long inline sections that could be split out.
Suggestions
Trim narrative asides like 'A fast no-op when everything is current; otherwise it refreshes...' and the 'While onboarding, also set expectations in one breath:' preamble to tighten conciseness.
Consider moving the detailed storyboard grammar (scene-unit detection, diff-chaining rules, note→transition table) into a separate references/ file referenced from the Storyboards section, leaving the overview inline.
Move the motion decoding field-notes (loop-wrap tail handling, bezier preservation, selectorFor rules) into a one-level-deep reference so the Motion section reads as an overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, operational content that assumes Claude's competence (no explanations of what Figma/GSAP are), but a few asides pad it slightly — e.g. 'A fast no-op when everything is current; otherwise it refreshes...' and 'While onboarding, also set expectations in one breath:' followed by a long parenthetical — which could be trimmed. | 4 / 5 |
Actionability | Fully executable guidance throughout: exact CLI invocations (`hyperframes figma asset '<ref>' [--format ...] [--scale 2]`), named helper functions with arguments (`motionContextToDocs(rawResponse, { selectorFor, repeat })`), and a complete verify command with flags and thresholds — copy-paste ready. | 5 / 5 |
Workflow Clarity | A phased workflow table sequences the process, and each risky/batch phase has explicit validation checkpoints and feedback loops: token preflight, mandatory 'Validate against ground truth', `npx hyperframes check` before completion, and error-recovery mappings for BAD_TOKEN/FORBIDDEN/RATE_LIMITED. | 5 / 5 |
Progressive Disclosure | Well-organized with clear section headers and one real, well-signaled bundle file (scripts/verify-motion.mjs, referenced inline at the validation step). However the storyboard grammar and motion decoding rules are long inline sections that could plausibly live in separate reference files, leaving minor organization gaps. | 4 / 5 |
Total | 18 / 20 Passed |