Content
67%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.
The body is a tight, well-organized overview with a sensible workflow, but its terminal render step is not executable — it names the renderer without a command — and the bundle it depends on is unverifiable in the delivered skill. Adding a concrete render invocation would close the largest gap.
Suggestions
Replace the vague render step with an executable command or minimal CLI example (e.g., the exact html-video/HyperFrames render invocation with output path and aspect-ratio flags).
Add a brief post-render validation checkpoint (verify duration, aspect ratio, and that no network assets broke the headless render).
Remove the line that repeats the frontmatter description verbatim, and include a short file listing of `source/` so the referenced bundle structure is navigable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Genuinely lean: concrete render specs ("MP4 / WEBM at 16:9, 9:16, 1:1, default 15s, 60fps") with no explanation of concepts Claude already knows. Not a 5 because the opening line duplicates the frontmatter description verbatim — one line that does not earn its place. | 4 / 5 |
Actionability | Step 1 points to a concrete path (`source/index.html`) and steps 2-3 are specific, but the terminal and most critical step ("Render to MP4 via the html-video / HyperFrames renderer") provides no executable command, and there is no code or CLI example anywhere in the body. Concrete guidance exists but is incomplete. | 3 / 5 |
Workflow Clarity | A clear four-step sequence (read template → replace copy → keep self-contained → render) with a checkpoint-like constraint ("do not introduce external network assets that would break a headless render"). Not a 5 because there is no validation step for the render output, and this is a multi-step process so the simple-skill exception does not fully apply. | 4 / 5 |
Progressive Disclosure | A short, well-sectioned overview with a clearly signaled one-level-deep reference (`source/index.html`). Not a 5 because, scored against the actual bundle structure, no bundle files exist in this skill copy — the referenced path cannot be verified and no listing of the `source/` tree is provided to aid navigation. | 4 / 5 |
Total | 15 / 20 Passed |