Content
85%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, workflow-tight body: executable commands, explicit validation feedback loops, and disciplined rules with no filler. Its main defects are broken bundle wiring — four referenced root-level files (including the gate-required visual-styles.md and the fallback house-style.md) don't exist, and the animation-map script path is wrong — plus some duplicated rationale in the OpenDesign section.
Suggestions
Ship or fix the four missing root-level references — visual-styles.md, house-style.md, patterns.md, and data-in-motion.md. Two are load-bearing: the Visual Identity Gate's step 3 requires visual-styles.md, and house-style.md is the mandated default when no style is given, so following the skill as written dead-ends.
Correct the animation-map invocation to the script's actual location (scripts/animation-map.mjs relative to the skill) instead of `design-templates/hyperframes/scripts/animation-map.mjs`.
Deduplicate the daemon-dispatch rationale: the sandbox-exec explanation in scaffold step 4 and the later "Reserve the daemon dispatch for render/inspect/preview... Do not run HyperFrames render yourself" paragraph repeat the same instruction; keep one.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, rule-driven, and free of teaching Claude things it already knows — tables of data attributes, exact GSAP/CSS snippets, and CLI invocations with flags dominate. It misses 5 because of minor padding: the daemon-dispatch rationale is stated twice (scaffold step 4's sandbox-exec explanation, then again "Reserve the daemon dispatch for render/inspect/preview... Do not run HyperFrames render yourself" a few paragraphs later), and the "OpenDesign integration" section re-explains the cache-slot rationale twice. It is above 3 because there is no concept-splaining filler, only operational content with a few redundant passages. | 4 / 5 |
Actionability | Guidance is fully executable: a copy-paste-ready bash scaffold + daemon dispatch + wait-loop (with exit-code semantics 0/2/5), exact GSAP tween code with eases and positions, concrete CSS for scene layout, and CLI commands with specific flags ("--samples 15", "--at 1.5,4,7.25", "--no-contrast") plus fix hints for each failure mode. This matches the anchor of copy-paste-ready commands covering the common cases; the only placeholders ("<descriptive-name>.mp4") are deliberately user-supplied. | 5 / 5 |
Workflow Clarity | Multi-step processes are explicitly sequenced with validation checkpoints and feedback loops: the 5-step Approach, the scaffold → edit → dispatch → wait render flow, an Output Checklist ("lint and validate both pass", "inspect passes, or every reported overflow is intentionally marked"), and explicit retry loops ("Re-run hyperframes validate until clean", "Re-run after fixes"). This matches the anchor-5 example's validate → fix → re-validate pattern; not 4 because checkpoints are explicit rather than implicit at every fragile step. | 5 / 5 |
Progressive Disclosure | The References section is well-signaled (each entry has a "Read when..." activation condition and stays one level deep), but scoring against the actual bundle reveals broken navigation: `visual-styles.md`, `house-style.md`, `patterns.md`, and `data-in-motion.md` are referenced from the body yet absent from the bundle — two of them load-bearing (the HARD-GATE step 3 requires visual-styles.md; house-style.md is the mandated fallback when no style is specified). Additionally the animation-map command points at `design-templates/hyperframes/scripts/animation-map.mjs` while the actual script is `scripts/animation-map.mjs`. Structure and signaling are good (above anchor 2's inlined-content problem), but "references mostly clear and working" (anchor 4) is not met when four referenced files are missing and a script path is wrong. | 3 / 5 |
Total | 17 / 20 Passed |