Content
82%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 tight, executable single-command skill body: lean on tokens, concrete in its command and rules, and clear about prerequisites and downstream ordering. The small deductions come from the invisible `--audio` option in the usage line, the unpathed script reference, and the absence of an explicit output-validation step.
Suggestions
Add `--audio creator|music|none` to the Run usage line so every option appears in the copy-paste command rather than only in the bullet list.
Invoke the script by its bundle path (e.g. `python scripts/compose.py ...`) so the reference matches the actual file location.
Add a brief validation step — e.g. confirm the compose summary line / output duration before handing off to caption-burn — to close the workflow's missing feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~35-line body is lean and operational — 'The take goes in as generated', '0.30 keeps the head in the upper third' — with no concept explanations, no padding, and every token earning its place. | 5 / 5 |
Actionability | The Run block gives a copy-paste-ready bash command with every flag documented in the bullets, but the `--audio creator|music|none` option never appears in the usage line and the script is invoked as `compose.py` without its bundle path (`scripts/compose.py`), leaving minor gaps. | 4 / 5 |
Workflow Clarity | Prerequisites and ordering are explicit ('re-render it after align_beats.py', '--draft layers are refused', 'Captions come after this'), but there is no written validation checkpoint for confirming the render succeeded or an error-recovery loop before handing off to caption-burn. | 4 / 5 |
Progressive Disclosure | Under 50 lines with well-organized '## Run' and '## Rules' sections and no external references needed, but the one bundle file is referenced without its actual path — the skill says `python compose.py` while the script lives at scripts/compose.py, a minor organization gap. | 4 / 5 |
Total | 17 / 20 Passed |