Content
75%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 tight, executable skill body: concrete CLI commands, a well-sequenced workflow with validation before render, and a clear completion standard. The main gaps are the absence of a minimal example composition (the one artifact Claude must author correctly), an unstated fix-and-revalidate loop for lint/inspect failures, and an intro paragraph that restates the frontmatter description.
Suggestions
Add a minimal, copy-paste-ready example composition HTML showing the root data-composition-id/data-width/data-height element, one timed clip, and a GSAP timeline registered on window.__timelines — this would close the actionability gap for the core artifact.
Make the validation loop explicit: after lint/inspect, state 'If issues are found (e.g., text or HUD elements outside the frame), fix the composition and re-run inspect until clean before rendering', which upgrades workflow clarity to include error-recovery feedback.
Trim the opening paragraph that re-lists trigger scenarios already covered by the frontmatter description, and fold the 'Do not stop after writing HTML' reminder into the Delivery checklist to remove duplicated guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — terse command blocks and rule bullets with no textbook explanation of HTML/CSS/JS — but the opening paragraph ('Use this skill when the user asks Hermes to make a video with HyperFrames, such as a 30-second vertical video, a short intro, a cinematic micro-trailer...') largely duplicates the frontmatter description, and 'Do not stop after writing HTML' overlaps the Delivery section. These are minor trimmable instances, matching anchor 4 rather than anchor 5's 'every token earns its place'. | 4 / 5 |
Actionability | Workflow and Setup give copy-paste-ready commands ('npx hyperframes init my-video --non-interactive', 'lint', 'inspect --samples 15', 'render --output final.mp4 --quality standard') plus concrete attribute names (data-composition-id, data-start, window.__timelines). Not anchor 5: there is no example composition HTML demonstrating the data-* structure or timeline registration, so the core artifact is described but not copy-paste ready; not anchor 3: guidance is concrete and executable, not pseudocode. | 4 / 5 |
Workflow Clarity | A clear 7-step numbered sequence with an explicit validation checkpoint ('Validate before rendering: lint, inspect --samples 15'), environment triage ('npx hyperframes doctor'), and a completion criterion ('only complete after... lint and inspect, and rendered to an MP4'). Not anchor 5: the fix-and-revalidate loop when lint/inspect report issues (e.g., text outside the frame) is implied but never stated as a retry step; not anchor 3: validation steps are explicit and correctly placed, not implicit. | 4 / 5 |
Progressive Disclosure | Well-organized single-file structure (Setup, Workflow, Composition Rules, Delivery) with no nested or buried references — no bundle files exist, so there is nothing misleading to navigate. Not anchor 5 (via the under-50-lines exception): the body runs ~73 lines and the data-attribute/Composition Rules detail sits inline where a one-level-deep reference file could carry it; not anchor 3: content is appropriately placed for a skill of this size and navigation is trivial. | 4 / 5 |
Total | 16 / 20 Passed |