Content
77%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with executable code and a clear, validated workflow, but it is slightly verbose in places and references several root-level files that are absent from the bundle. Fixing the missing references and trimming explanatory prose would lift the two weaker dimensions.
Suggestions
Add the missing root-level reference files referenced as essential (house-style.md, visual-styles.md, patterns.md, data-in-motion.md) or update the body links to point at files that exist in the bundle.
Tighten or remove explanatory prose blocks (e.g. 'Why this matters' and guardrail rationales) so the body earns every token, lifting conciseness.
Consider moving the longest inline detail (e.g. the full Scene Transitions rule block or Quality Checks) into a one-level reference if it grows, to keep SKILL.md a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean (rules, attribute tables, executable code) and avoids explaining concepts Claude already knows, but several explanatory prose blocks ('Why this matters', guardrail rationales) could be tightened further, fitting the 'mostly efficient but could be tighter' anchor rather than fully lean. | 2 / 3 |
Actionability | Provides fully executable HTML/JS/CSS snippets, exact data-attribute tables, specific CLI commands ('npx hyperframes lint', 'npx hyperframes validate'), and concrete guardrails with code, making it copy-paste ready. | 3 / 3 |
Workflow Clarity | Clear sequenced process (What -> Structure -> Timing -> Layout -> Animate), a numbered 'Layout Before Animation' procedure, an Output Checklist, and validation feedback loops (lint -> validate -> inspect, re-run until clean) with explicit checkpoints. | 3 / 3 |
Progressive Disclosure | The References section is well organized and one-level-deep with 'Read when...' signals, but four root-level referenced files (visual-styles.md, house-style.md, patterns.md, data-in-motion.md) are missing from the bundle despite the body marking house-style.md/typography as 'always read', which breaks navigation and keeps this below the well-signaled/complete anchor. | 2 / 3 |
Total | 10 / 12 Passed |