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 strong, highly actionable body with excellent validation feedback loops and near-zero filler. The main defect is progressive disclosure: four referenced files are absent from the bundle (including house-style.md, which the Visual Identity Gate depends on) and the transitions reference chain nests three levels deep.
Suggestions
Add the missing bundle files (visual-styles.md, house-style.md, patterns.md, data-in-motion.md) or repoint their links to files that actually exist in references/ — house-style.md is required by the Visual Identity Gate and the 'no style specified' fallback, so its absence breaks the gate's step 3/4 flow.
Flatten the transitions chain: inline the routing table from transitions/catalog.md into references/transitions.md, or link the per-type css-*.md files directly from SKILL.md so no path requires three hops.
Tighten conciseness by condensing the 'Why this matters' rationale under Layout Before Animation to one sentence and removing the overlap between the numbered Scene Transition rules and their adjacent WRONG/RIGHT example comments.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and rule-driven with almost no tutorial filler — tables for data attributes, numbered non-negotiables, and compact code blocks earn their tokens. It sits at anchor 4 rather than 5 because of minor over-explanation that could be trimmed, e.g. the multi-sentence 'Why this matters' rationale under Layout Before Animation and some restatement between the Scene Transitions rules and their WRONG/RIGHT examples. | 4 / 5 |
Actionability | Guidance is copy-paste executable throughout: complete HTML/JS snippets (sub-composition template, video/audio elements, entrance/exit tween blocks), exact commands ('npx hyperframes inspect --json', 'node skills/hyperframes/scripts/animation-map.mjs <composition-dir>'), and precise formulas such as 'repeat: Math.ceil(duration / cycleDuration) - 1'. This matches anchor 5; common cases are covered with specific examples. | 5 / 5 |
Workflow Clarity | The Approach section sequences the work (What → Structure → Timing → Layout → Animate), the Output Checklist enumerates validation gates, and the Quality Checks section provides explicit feedback loops: 'Re-run hyperframes validate until clean' and 'Re-run after fixes'. Anchor 5 (clear sequence, explicit validation, feedback loops, checklists) matches directly. | 5 / 5 |
Progressive Disclosure | The References section is well-signaled (each entry says what it covers and 'Read when...'), but scored against the actual bundle it breaks down: visual-styles.md, house-style.md, patterns.md, and data-in-motion.md are linked in the body and references but do not exist in the bundle (house-style.md is load-bearing — the HARD-GATE and animation defaults depend on it), and the transitions chain nests three levels deep (SKILL.md → references/transitions.md → transitions/catalog.md → per-type css files). Broken navigation plus 2+-level nesting places this between anchors 3 and 4, closer to 3 because the missing files cause real navigation failures rather than mere organization gaps. | 3 / 5 |
Total | 17 / 20 Passed |