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.
An unusually executable skill: exact commands, pinned assets and voice, hard validation gates with fallback paths, and well-integrated one-level references. The two real defects are the missing `examples/master-skeleton.html` (breaks step 0's foundational copy command) and repeated restatement of the same critical rules across sections and the anti-patterns table.
Suggestions
Ship `examples/master-skeleton.html` in the bundle (or point step 0 to a real path) — the scaffold copy is the foundation of steps 0 and 5 and currently fails as written.
Consolidate the scaffold/caption rules into one authoritative statement plus one anti-pattern row each; the same warning currently appears in step 0, the recovery paragraph, and two table rows.
Trim the parenthetical history (e.g. "This is exactly what went wrong on the Jul 13-20 v4 build") — the gate rule stands without the dated anecdote.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is directive and assumes competence — no explaining what ffmpeg, TTS, or forced alignment are — and every section instructs rather than describes. Not a 5 because critical rules are restated several times in slightly different forms: the scaffold rule appears in the step 0 bold warning, the "If you catch yourself reaching for cp..." recovery paragraph, and two anti-pattern table rows; likewise captions are emphasized in steps 4, 5, 6 and two more table rows. These repetitions could be consolidated without losing the gate. | 4 / 5 |
Actionability | Commands are copy-paste ready with exact flags and pinned values: the ffmpeg background encode ("-vf scale=1080:1080,fps=30,eq=saturation=0.72..."), the TTS call with pinned voice ID "330290724a1b470fb63153f34d4c0183", the uvx whisper fallback, and the full `check --caption-zone` parameter string. Not a 5 because step 0's `cp <SKILL_DIR>/examples/master-skeleton.html project/index.html` references a file that does not exist in the bundle (no `examples/` directory ships), so the foundational copy command fails as written. | 4 / 5 |
Workflow Clarity | Steps 0-6 are clearly sequenced with explicit validation gates and feedback loops: "resolve every one before building" for MISMATCH warnings, the "Word-timings are a hard gate" check with a whisper fallback path, "all green before presenting" in step 6, and the hard-fail caption presence gate with a named recovery step ("re-check step 5's LINES population"). This matches the anchor of clear sequence plus explicit validation and error-recovery loops. | 5 / 5 |
Progressive Disclosure | The body is a well-signaled router: `references/build-spec.md` ("read end-to-end"), `references/visualization-registry.md` ("route every theme/item through... BEFORE writing the script"), `references/script-voice.md`, `references/lexicon.json`, and `scripts/align-captions.mjs` all exist in the bundle, one level deep, each with a clear when-to-read cue. Not a 5 because the referenced `examples/master-skeleton.html` — the file step 0 and step 5 depend on entirely — is missing from the bundle, a dangling critical reference. | 4 / 5 |
Total | 17 / 20 Passed |