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 genuinely lean, well-structured template skill with a clear sequenced workflow and sensible constraints. Its weakness is actionability: the critical render step and the location of editable copy remain underspecified, with no executable commands and no verification checkpoint on the render output.
Suggestions
Make the render step executable: include the actual html-video / HyperFrames render command (with output path and format/fps flags) instead of the directional 'Render to MP4 via the html-video / HyperFrames renderer'.
Point to where the sample copy lives — e.g., the named layers/selectors in `source/index.html` holding headlines, figures, and labels — so step 2 can be executed without exploring the file blind.
Add a light verification checkpoint after rendering (e.g., confirm the output is 20s / 30fps / 16:9 and scenes play in order) to close the workflow's validation gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~30-line body is lean: it states what the template is ("HTML + CSS + GSAP motion composition, bundled under `source/`", "MP4 / WEBM at 16:9, default 20s, 30fps"), a 4-step workflow, and attribution — no explanations of concepts Claude already knows and no padding. Every section earns its place, so it clearly matches the 'lean and efficient' anchor rather than score 4's 'minor instances of over-explanation'. | 5 / 5 |
Actionability | Guidance is directionally concrete — named files ("Read `source/index.html`"), a specific edit rule ("Replace the sample copy (headlines, figures, labels)... keep the motion timing and visual signature intact") — but no executable commands are given: the render step is only "Render to MP4 via the html-video / HyperFrames renderer" with no command, script, or flag, and there is no pointer to where in index.html the sample copy lives. This matches 'some concrete guidance but incomplete; missing key details', below score 4's 'concrete code or commands with minor gaps'. | 3 / 5 |
Workflow Clarity | The four steps are clearly sequenced (read → replace copy → keep self-contained → render) with a concrete preservation rule at step 2 and a constraint at step 3. It is below score 5 because there is no validation or verification checkpoint (e.g., confirming the render output duration/fps or spot-checking scenes), and above score 3 because the sequence is well-defined and each step is specific rather than merely listed. | 4 / 5 |
Progressive Disclosure | The body is short and well organized into 'What this template is', 'Workflow', and 'Attribution', pointing to `source/index.html` as the one level of depth for detail — good structure for a compact skill. It is below score 5 because the referenced bundle path (`source/`) is not present alongside the SKILL.md, so the reference cannot be verified and no navigation over the bundle's files (e.g., what else lives under `source/`) is provided. | 4 / 5 |
Total | 16 / 20 Passed |