Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A dense, highly actionable runbook with exact codec/filter parameters and a clear step sequence, backed by real bundle scripts. The two weak spots are absent validation checkpoints for a failure-prone batch/mux operation and some routing-detail repetition across sections.
Suggestions
Add an explicit verification checkpoint after the mux pass (e.g., probe audio bitrate/codec with ffprobe and re-run the mux if it reads ~1 kbps) to turn the known 'garbage audio' failure mode into a validate→fix→retry loop.
Consolidate the birefnet/music routing notes so each routing decision is stated once — step 4 already covers music routing and the Gaps section restates it, which inflates token cost.
Surface the per-BG-variant batch loop as a named validation step (verify each variant's duration/resolution before mux) so the batch operation has a checkpoint rather than an implied one.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and technical with no concept-explanation padding, but the separate-pass-mux rationale and the birefnet/music routing story are restated across the Run, Contract, and Gaps sections and could be consolidated. Not a 3 because 'every token earns its place' is undercut by this cross-section repetition; not a 1 because nothing explains concepts Claude already knows. | 2 / 3 |
Actionability | Gives concrete executable guidance — named scripts, exact FFmpeg params ('h264 crf20 yuv420p +faststart 30fps', 'y=(H-h)/2', loudnorm 'I=-18:TP=-2:LRA=9', '-map 0:v:0 -map 1:a:0') and numeric craft values (saturation=0.50/0.85, ~75%/65% width). Not a 2 because it is copy-paste-ready rather than pseudocode or incomplete. | 3 / 3 |
Workflow Clarity | A clear 4-step Run sequence exists, but this is a batch operation (one filter_complex per BG variant) with a known failure mode ('silently ships 1 kbps garbage audio') and no explicit validate→fix→retry checkpoint. Per the batch/destructive guideline this caps at 2; not a 1 because the sequence itself is clearly ordered. | 2 / 3 |
Progressive Disclosure | SKILL.md is an overview/contract runbook that points by name to four real scripts in scripts/ (strip_product_backgrounds.py, render_overlays.py, composite_variants.py, music_and_mux.py) at one level of depth, with well-organized Run/Contract/Gaps sections. Not a 2 because references are clearly signaled and appropriately split rather than inlined or nested. | 3 / 3 |
Total | 10 / 12 Passed |