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.
A strong, dense operational contract: nearly every line is a production-earned gotcha with concrete ffmpeg/PIL parameters, and bundle references are real, clearly signaled, and one level deep. It loses points for repeated 'FREE/$0' framing, a duplicated crossfade rationale, and the lack of any complete runnable command in the body itself.
Suggestions
Consolidate the 'FREE / deterministic / $0' framing into one statement (e.g., the Run section) and cut its repetition from the intro and Contract, and drop the second crossfade explanation — the rationale appears both in the intro and the Contract bullet.
Include one complete copy-paste ffmpeg command in the body (e.g., a single-beat ken-burns + concat example) so the most common case is runnable without opening the bundle files.
Move the caption rule specifics (NON-OVERLAP formula, PIL subject-shift recipe) into a referenced file and keep a one-line rule per bullet in the Contract to cut token cost.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly dense operational gotchas Claude would not know (the '-loop 1' + 'zoompan d=N' trap, the caption clamp formula, the libass fallback), but the 'FREE, deterministic / $0' framing is repeated across the intro, Run, and Contract sections and the crossfade rationale appears twice — minor padding to trim. | 4 / 5 |
Actionability | Concrete, near-executable guidance throughout ('-map 0:v:0 -map 1:a:0', zoompan 1.0→~1.06× with '-t' + 'trim', 'enable=\'between(t,st,en)\'', 'end = min(last_word_end + ~0.15, next_start - 0.03)'), but the body contains no single complete runnable command — full examples are delegated to the bundle files. | 4 / 5 |
Workflow Clarity | The Run section gives a clear sequence (ken-burns each keyframe → hard-concat → mux → burn captions → end card) with a validation checkpoint ('check ffmpeg -filters first' before libass) and an error-recovery rule (shift the subject up if it intrudes into the caption band), but the fully ordered steps live in PIPELINE.md and some checkpoints (e.g., verifying beat timing) are implicit. | 4 / 5 |
Progressive Disclosure | The body is a well-organized overview pointing to verified, clearly signaled, one-level-deep bundle files (scripts/config.example.json, scripts/PIPELINE.md, scripts/README.md), each with a stated role — easy navigation and an appropriate content split. | 5 / 5 |
Total | 17 / 20 Passed |