Content
81%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 well-architected, highly actionable skill with an exemplary gated render pipeline and clear reference structure. Its main weakness is a broken reference — the master-skeleton scaffold it tells Claude to copy is missing from the bundle — plus some repeated emphatic prose that could be tightened.
Suggestions
Ship `examples/master-skeleton.html` in the bundle (or correct the `cp` path) — step 0, build-spec.md, and the anti-patterns table all point to it, but the file is absent, breaking the primary executable instruction.
Tighten the bootstrap section: the 'don't start from a prior video' warning is conveyed in the prose, the STOP-and-restart paragraph, and the anti-patterns table — collapse to one authoritative statement and let the table carry the rest.
De-duplicate brand-token rules between SKILL.md step 5 and references/build-spec.md so the body points rather than restates, reducing token cost without losing the cross-reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and assumes Claude's competence with no elementary padding, but the bootstrap section restates the 'don't copy a prior video' warning across the prose, the STOP-and-restart paragraph, and the anti-patterns table, and re-emphasizes brand rules already in build-spec.md — minor trimmable repetition. | 4 / 5 |
Actionability | Mostly executable copy-paste bash (cp, ffmpeg encode with full vf chain, node TTS with pinned voice id, align-captions flags, full check command with caption-zone args), but step 0's first `cp <SKILL_DIR>/examples/master-skeleton.html` targets a file absent from the bundle, a concrete execution gap keeping it just below fully ready. | 4 / 5 |
Workflow Clarity | A clearly sequenced 0–6 pipeline with explicit validation checkpoints and feedback loops — the word-timings hard gate, whisper forced-alignment fallback, and the frame-sampling caption-presence hard-fail gate — exactly the validate→fix→retry pattern the rubric rewards for render/destructive work. | 5 / 5 |
Progressive Disclosure | Good one-level-deep structure: references/ (build-spec, visualization-registry, script-voice, lexicon), scripts/align-captions.mjs, and assets/ are clearly signaled from the body, but `examples/master-skeleton.html` is referenced in both the body and build-spec.md yet does not exist in the bundle — a navigation dead-end. | 4 / 5 |
Total | 17 / 20 Passed |