Content
78%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 well-structured contract overview with strong per-scene QC feedback loops and clean one-level-deep references to real bundle files. Its main gaps are the absence of any copy-paste code or script invocation in the body itself, and notable duplication of the description's pipeline summary.
Suggestions
Add at least one complete, copy-paste-ready example — e.g., the exact ffmpeg composite command or the `scripts/stitch.py` invocation — so the body is executable without opening the referenced files.
Remove the pipeline summary already covered by the description (cut-to-bar + hard concat + logo bug + captions + end card + song mux) to tighten the body and avoid redundancy.
Make the in-body run order explicit with a short numbered sequence (or a one-line pointer to PIPELINE.md's 6-step order) so the contract reads as a sequenced workflow rather than parallel bullets.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and largely token-efficient, skipping generic explanations, but it duplicates much of the description (cut-to-bar, hard-concat, logo bug, captions, end card) and carries a few padded parentheticals ('A diffusion model garbles a wordmark'). | 4 / 5 |
Actionability | Provides concrete, specific parameters (librosa 4/4, ~4–5 words/cue, margin_v, `overlay=…:enable='between(t,st,en)'`, `loudnorm I=-14`, 1080×1920 h264+aac) and a real ffmpeg filter fragment, but includes no complete copy-paste code block or script invocation in the body itself. | 4 / 5 |
Workflow Clarity | The QC bullet is a strong explicit feedback loop (per-scene QC, FACE/HAND crops, regenerate the drifted KEYFRAME not re-cut, re-check served bytes after publish), but the in-body contract is presented as parallel bullets rather than a strictly ordered run sequence (the ordering lives in PIPELINE.md). | 4 / 5 |
Progressive Disclosure | The body is a clear overview with well-signaled one-level-deep references to real bundle files (`scripts/config.example.json`, `scripts/PIPELINE.md`, `scripts/README.md`), each annotated with what it contains; content is appropriately split between SKILL.md and scripts/. | 5 / 5 |
Total | 17 / 20 Passed |