Content
96%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.
An exemplarily lean, command-first skill body: every run command is executable, defaults and constraints are quantified, and the batch-render workflow includes explicit validation and feedback loops. The only structural weakness is that the footprint helper is not named or invocable from the page, unlike the other bundled scripts.
Suggestions
Name the footprint script explicitly (scripts/footprint.py) and show its command line in a code block, as is done for transcribe.py/captions.py/plates.py, since 'the bundled footprint helper' is currently uninvocable from the page.
Mention scripts/media_proxy.py and scripts/_fonts.py in one line (e.g. what media_proxy.py serves and when _fonts.py fetches Roboto) so every bundle file is discoverable from SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with operational detail and zero padding: no concept explanations, no library intros, every sentence carries a flag, default, or constraint (e.g. "plate 25% above / 75% below", "cap ~0.019 H", "~14 characters a line"). It matches the score-5 anchor — lean, assumes Claude's competence, every token earns its place — and is well above the score-4 'minor instances of over-explanation' case. | 5 / 5 |
Actionability | Every workflow is given as a copy-paste-ready command with real flags and defaults: `python captions.py --video reel.mp4 --beats cutlist.aligned.json --words reel.words.json --out final.mp4 [--style plate|outline]`, plus concrete card syntax `--card "LINE ONE|LINE TWO" --card-until 4.7`. The beats input format is specified ("Any file with `beats: [{start, end, vo}]` works"), covering the common cases like the description's examples do at score 5. | 5 / 5 |
Workflow Clarity | The sequence (transcribe finished audio → captions burn → inspect) is explicit, and the batch render operation has real validation checkpoints and feedback loops: "regenerate after alignment or copy changes", "Preview rejects a changed cut list until its footprint is rebuilt", "Inspect final captioned frames as well as this planned coverage", and "An explicitly supplied missing font fails in both commands" documents error behavior. This matches the score-5 anchor (explicit validation steps plus error-recovery loops) for a batch operation that would otherwise be capped at 3. | 5 / 5 |
Progressive Disclosure | The body is well organized into Run / Placement and style / plates.py / Rules / Footprint sections and the scripts it names (transcribe.py, captions.py, plates.py) exist in the scripts/ bundle with commands shown. However the footprint tool is referred to only as "the bundled footprint helper" without naming footprint.py or giving its command line, and media_proxy.py/_fonts.py are never mentioned — minor organization gaps that fit the score-4 anchor rather than the fully clear score-5 navigation. | 4 / 5 |
Total | 19 / 20 Passed |