Content
75%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 compact, well-structured instruction body with concrete run commands, a complete config schema, and unusually specific craft rules that encode real rendering gotchas. The main gaps are the missing config.example.json it advertises and the lack of a concrete mux/QC command plus an explicit error-recovery loop in the output pipeline.
Suggestions
Ship the referenced config.example.json (the Glossier worked example) or fix the path so the body's promise of a full worked config resolves to a real file.
Replace 'Generate + mux the create-music-elevenlabs bed with a short fade in/out + loudnorm' with the actual copy-paste ffmpeg command(s) including the -map 0:v:0 -map 1:a:0 and fade arguments.
Add an explicit feedback loop after the stills quick-check, e.g. 'if a product is off-center or the ring clips, adjust slides[].image or phrase length and re-render stills before building the full master'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence: the Run section is two commands, the config shape is a compact field list, and craft rules state non-obvious constraints ('an L<246 threshold') without padding. Minor trimming is possible — the card-chrome inventory repeats the description nearly verbatim and 'Deterministic and FREE' restates frontmatter claims. | 4 / 5 |
Actionability | The Run commands are copy-paste ready ('python3 scripts/build.py --config config.json --assets <stills-dir> --out master-silent.mp4') and the config shape documents every field, and craft rules give executable constants (L<246, top 50%). Not a 5 because the body points to 'config.example.json' as a full worked config but that file is absent from the bundle, and the music-mux step is delegated without a concrete ffmpeg/loudnorm command. | 4 / 5 |
Workflow Clarity | A clear sequence exists: render stills ('quick check — one frame per slide'), build the silent master, generate + mux the music bed with 'fade in/out + loudnorm', then 'QC with watch'. The stills check is an explicit validation checkpoint before the expensive steps; it falls short of a 5 only because there is no explicit fix-and-retry guidance if the stills QC or loudnorm step fails. | 4 / 5 |
Progressive Disclosure | Well-organized sections (Run, Choices, Craft rules, Output) with implementation correctly pushed to scripts/build.py (310 lines) and only an overview kept inline, one level deep. Not a 5 because the worked-example reference 'config.example.json is a full worked config (Glossier)' is dangling — the file does not exist in the bundle — leaving the reader without the promised navigable detail. | 4 / 5 |
Total | 16 / 20 Passed |