Content
92%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is an exceptionally lean, highly actionable Remotion reference with executable code, exact commands, and clear conditional guidance. Its one real defect is that the progressive-disclosure references point to bundle files that are not present, undermining the otherwise excellent file-split navigation.
Suggestions
Ship the referenced bundle files (text-highlights.md, voiceover.md, effects.md, transitions.md, etc.) in references/ so the one-level-deep navigation actually resolves.
Consider moving the long effects-name catalog (line 173) into effects.md and linking to it, keeping SKILL.md as a tighter overview.
Add a short orienting line near the top summarizing what the reader will find in the inline rules versus the linked sub-files to aid navigation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean, rule-dense reference with terse directives like 'Animate properties using `useCurrentFrame()` and `interpolate()`' and 'CSS transitions or animations are FORBIDDEN', assuming Claude's competence and never explaining what Remotion or React is; every line earns its place, fitting 'lean and efficient; assumes Claude's competence'. The only large block is the effects-name catalog, which is actionable reference material rather than padding, so it stays at score 3 rather than 2. | 3 / 3 |
Actionability | It provides fully executable tsx components (e.g., `FadeIn`, `MyComposition`), exact CLI commands (`npx remotion still [composition-id] --scale=0.25 --frame=30`, `npx remotion add @remotion/media`), specific named APIs (`Interactive.Div`, `Easing.bezier(0.16, 1, 0.3, 1)`), and good/bad (👍/👎) contrast examples, matching 'fully executable code/commands; copy-paste ready'. | 3 / 3 |
Workflow Clarity | Though primarily a rule reference, the guidance that does involve sequencing is unambiguous: the visual-effects section gives an explicit ordered priority (1→2→3→4) and the preview/render-check sections state clear conditions ('Skip it for trivial edits', 'Only do this if you think the user wants to see the preview'). As a non-destructive reference skill it does not require validation feedback loops, so clear conditional ordering here warrants score 3 rather than 2. | 3 / 3 |
Progressive Disclosure | On paper the body is an overview pointing to ~30 separate one-level-deep files, each clearly signaled with 'See [file.md]' plus a one-line topic description, but the referenced bundle files (text-highlights.md, voiceover.md, effects.md, etc.) do not exist on disk — there is no references/, scripts/, or assets/ directory and no sibling .md files. Well-signaled but broken references cannot reach score 3, and it sits above score 1 because the intended structure and navigation are clear and shallow. | 2 / 3 |
Total | 11 / 12 Passed |