remotion-script-writer
Installation
SKILL.md
Remotion Script Writer
Turn a video goal plus (optionally) a codebase into a Remotion Script JSON — a scene-by-scene specification precise enough that a Remotion agent can implement it without asking follow-up questions. The governing principle: the script is the single source of truth for the render — every duration, element, animation, and voiceover line is stated in numbers and exact strings, never "about 5 seconds" or "some intro text". Two agents given the same input must emit structurally identical scripts.
When to use / when not to
- Use when the output will be rendered programmatically with Remotion: product demos of web apps, coding tutorials with animated code, motion-graphics pieces, data-visualization videos, short-form social animations.
- Concept and beats not yet decided for a product video → run
skills/creative/product-videofirst; its beat sheet becomes this skill's scene list. - Person-on-camera video →
skills/creative/talking-head(Remotion is not the tool). - Static graphics →
skills/creative/social-graphics. - This skill writes the script only — implementing the React components, previewing in Remotion Studio, and rendering are done by Remotion's own agent skills downstream.
Rules files — read before writing the script
rules/prompt-structure.md— the input fields the script is built from (goal, targetAudience, code, videoType, duration, style, animations, transitions). Read it when normalizing intake into the input object.rules/script-generation.md— the authoritative output JSON structure and generation instructions. Read it before emitting the script; the skeleton below is a summary, that file is the contract.rules/animation-patterns.md— the approved animation/transition vocabulary with exact JSON shapes and timing guidelines. Read it when specifying anyanimationortransitionToNextScenevalue; do not invent animation types outside it.rules/scene-templates.md— ready-made scene JSON for common cases (title card, feature showcase, code walkthrough, data viz, outro/CTA). Read it when a scene matches a known pattern; start from the template and edit.examples/product-demo-example.json— a complete worked script. Read it for calibration on granularity.