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.
The body is an efficient, highly actionable command reference that packs real gotchas into few tokens, with only a bare `npx remotion still` example and no output-verification guidance as minor weaknesses. Its main structural defect is that both referenced detail files (transparent-videos.md, opentimeline.md) are missing from the bundle, breaking progressive disclosure for those optional paths.
Suggestions
Add the missing transparent-videos.md and opentimeline.md bundle files (or inline/remove the references), since both links currently resolve to nothing.
Show a complete still-render example with composition ID and output path (e.g., `npx remotion still [composition-id] out/still.png`), consistent with the skill's own advice to always pass the composition ID.
Add a brief verification step after rendering, such as confirming the output file exists or checking the command's exit status before reporting success.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: it never explains what Remotion is, and every section delivers executable commands plus genuinely non-obvious gotchas (interactive picker failure, zero-padded frame filenames, --is-production=false for test renders). | 5 / 5 |
Actionability | Commands are copy-paste ready for the common cases (render with props, license key, multi-frame export), but `npx remotion still` is shown bare with no composition ID or output path, contradicting the skill's own "Always pass the composition ID" rule. | 4 / 5 |
Workflow Clarity | The primary action is unambiguous and failure modes are pre-empted (list composition IDs, list the output folder instead of guessing filenames), but no verification step exists (e.g., confirm the output file was written or check the render exit status) and the batch --frames workflow has no validation checkpoint. | 4 / 5 |
Progressive Disclosure | Sections are well organized with clearly signaled one-level references, but the referenced files ./transparent-videos.md and ./opentimeline.md do not exist in the bundle (only assets/remotion-icon.svg is present), so those navigation links dangle and the split content is unavailable. | 3 / 5 |
Total | 16 / 20 Passed |