Content
70%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 a strong, actionable, well-sequenced workflow with an excellent mandatory verification step. It is somewhat verbose and monolithic — repeated guidance and inlined code that could live in reference files limit conciseness and progressive disclosure.
Suggestions
Move the full Root.tsx/Composition.tsx code and the keyframe design rules into reference files under references/, keeping SKILL.md an overview with one-level-deep pointers.
Dedupe the scroll/coordinate-change guidance so it lives in one place (Limitations) rather than repeated across Step 3, Step 6, and Limitation #1.
Define or annotate the placeholder constants (DURATION_SECONDS, FPS, VIDEO_WIDTH, DURATION) so the Remotion code is fully copy-paste-ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and free of generic concept explanations, but the opening marketing paragraph and repeated guidance (scroll/coordinate warnings appear in both Step 3 and Limitation #1, and Step 6 mistakes overlap with Limitations) could be tightened. | 3 / 5 |
Actionability | Provides concrete, mostly copy-paste-ready commands and code (ffprobe, ffmpeg, whisper-cli, PIL grid overlay, full Remotion tsx), but Root.tsx/Composition.tsx reference undefined constants (DURATION_SECONDS, FPS, VIDEO_WIDTH, DURATION) that the user must wire up, leaving minor gaps. | 4 / 5 |
Workflow Clarity | Steps 1-9 are clearly sequenced, and Step 6 is an explicit, emphasized validation feedback loop (render still -> self-review -> adjust coordinates -> re-render -> only proceed when all correct), with a checklist of common coordinate mistakes. | 5 / 5 |
Progressive Disclosure | Well-organized into clear sections, but it is a ~365-line monolithic SKILL.md with no bundle files; the full Remotion component code and keyframe design rules are inlined rather than split into references/, which is a progressive-disclosure weakness for a skill this size. | 3 / 5 |
Total | 15 / 20 Passed |