Content
71%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 tightly written, well-structured template skill with an excellent conciseness profile and a clear workflow, undermined by a vague render step with no executable command and a workflow anchored on source/index.html, which is absent from the provided bundle. Fixing the render command and shipping (or correcting) the source/ reference would lift the two weakest dimensions.
Suggestions
Add the concrete render invocation for the html-video/HyperFrames renderer (command or entry-point script) with the key flags (duration, fps, resolution), instead of 'Render to MP4 via the html-video / HyperFrames renderer'.
Ensure the referenced `source/` bundle (at minimum `source/index.html`) is actually included alongside SKILL.md, since the whole workflow depends on it.
Add a brief post-render check (e.g. verify output duration/resolution match 15s 16:9) to close the workflow's validation gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~30-line body is lean with zero padding: it never explains what GSAP, MP4, or 16:9 are, and every section ('What this template is', 'Workflow', 'Attribution') earns its tokens. This matches anchor 5 ('lean and efficient; assumes Claude's competence; every token earns its place') — there is no over-explanation to trim, so it cannot be anchor 4. | 5 / 5 |
Actionability | Steps 1-2 are concrete (a specific file to read, an explicit copy-replacement instruction with a preservation constraint), but the terminal and most important step — 'Render to MP4 via the html-video / HyperFrames renderer' — gives no command, flag, or entry point, and no render parameters are shown despite 15s/30fps being specified. Concrete-but-incomplete guidance with missing key details matches anchor 3 rather than anchor 4's 'concrete code or commands with minor gaps'. | 3 / 5 |
Workflow Clarity | The four steps are clearly sequenced (understand → customize → constrain → render) and step 3 acts as a guardrail against breaking headless renders. No validation step exists, but nothing here is destructive or batch, so the cap of 3 does not apply; the missing post-render verification keeps it at anchor 4 ('clear sequence with most checkpoints present; minor validation gaps') rather than anchor 5. | 4 / 5 |
Progressive Disclosure | Sections are well organized for a short skill, but the body's primary pointer — 'bundled under source/' and 'Read source/index.html' — does not exist in the bundle (no source/, references/, scripts/, or assets/ directories are present). Scored against the actual bundle structure per the rubric guidelines, the one referenced path is broken, which fits anchor 3 ('references present but not clearly signaled/usable') better than anchor 5's 'easy navigation' or the simple-skill exception. | 3 / 5 |
Total | 15 / 20 Passed |