agentleFS
muzimu217muzimu217/ui-design-agent-kit/.agents/skills/remotion-video-agent/SKILL.md

remotion-video-agent

Skill23 starsChanged 27 days agoApache-2.0View on GitHub

Create, animate, preview, render, or review React video compositions with Remotion. Covers frame-accurate timing, spring and interpolate motion, multi-scene sequencing, cinematic transitions, captions, media, and honest Studio/render verification. Use for Remotion videos or code-driven motion graphics, not ordinary web UI animation.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

22 rules. About 0 are common, 13 are distinctive, and 9 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈13

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 9

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    When a comparable treatment exists, search official examples and mature open-source projects first and adapt a named, inspectable baseline.

    line 20
  2. Distinctive:

    Use the surrounding open-source ecosystem as a deliberate comparison set: Remotion is the default for React and frame-accurate web …

    line 24
  3. Distinctive:

    Read workflow.md for the relevant mode and load only the official Remotion skill needed for the current request:

    line 35
  4. Distinctive:

    When this route is dispatched by a main agent, follow the kit's bounded concurrency policy: one active subagent per task, with dependent …

    line 38
  5. Distinctive:

    Before writing code, extract or reasonably assume:

    line 67
  6. Distinctive:

    When a task mentions one of these adjacent projects, verify its current official repository or documentation, version, command surface, and …

    line 82
  7. Distinctive:

    Do not change the brief's identity, claims, media, or target format without a reason.

    line 87
  8. Very specific:

    If the user asks for a web UI transition rather than a video, hand the task back to ui-design-agent and motion.

    line 89
  9. Very specific:

    Use useCurrentFrame() and useVideoConfig() inside renderable components.

    line 94
  10. Very specific:

    Use spring() for physical entrances, emphasis, or handoff moments when the overshoot is intentional.

    line 97
  11. Distinctive:

    Keep scene timing in a small, named contract.

    line 101
  12. Distinctive:

    Do not use wall-clock CSS transitions, CSS keyframes, Tailwind animation classes, or auto-playing browser animation timelines to drive …

    line 105
  13. Very specific:

    Prefer transform, opacity, clip, and color interpolation that renders deterministically.

    line 109
  14. Very specific:

    Use Easing.step1 for intentionally discrete string changes.

    line 112
  15. Very specific:

    Use staticFile() and Remotion media components for project assets.

    line 118
  16. Distinctive:

    Keep important text inside the actual video safe area.

    line 122
  17. Very specific:

    Add a missing package only in the target video project, aligning exact versions of all remotion and @remotion/* packages.

    line 129
  18. Very specific:

    Use TransitionSeries.Sequence for scenes and put a single TransitionSeries.Transition or TransitionSeries.Overlay between them.

    line 132
  19. Distinctive:

    Keep transition scenes absolutely positioned with the default absolute-fill layout.

    line 147
  20. Distinctive:

    Keep the BGM under the effects: duck 3–6 dB on every cue with a short attack and release.

    line 169
  21. Very specific:

    Write the cues down as data before writing audio code — a cue sheet with frame, track, sample, and why per row.

    line 177
  22. Distinctive:

    Only render a video when the user explicitly asks for a render or the task's deliverable is a rendered file.

    line 198

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Remotion Video Agent

Act as a motion designer and React video engineer. Translate a brief into a clear visual rhythm, then implement a deterministic, frame-accurate composition that can be edited in Remotion Studio. Cool transitions are a consequence of good scene intent, timing, and visual continuity; do not stack effects to hide weak composition or unclear storytelling.

Design animation as part of the product's interaction and brand system. Start from the user's audience, message, product behavior, and brand vocabulary, then choose movement, pacing, typography, sound or media treatment, and transitions that make those qualities legible. Remotion can express product launches, interaction walkthroughs, identity systems, explainers, and other motion-led stories; the correct treatment depends on the request, not on a preset style. When a comparable treatment exists, search official examples and mature open-source projects first and adapt a named, inspectable baseline. Reuse code or assets only when the license or user authorization permits it.

Use the surrounding open-source ecosystem as a deliberate comparison set: Remotion is the default for React and frame-accurate web compositions; Manim is the stronger reference for mathematical or scientific animation; Vibe Video and VibeFrame are agent-orchestration references when their current repositories and requirements are verified; Shotcut and OpenShot are editing and multi-track workflow references, not substitutes for Remotion's render model. This choice must follow the user's requested medium and delivery, and none of these projects is assumed to be installed, connected, or licensed for reuse without inspection.

Route the work

Read workflow.md for the relevant mode and load only the official Remotion skill needed for the current request:

When this route is dispatched by a main agent, follow the kit's bounded concurrency policy: one active subagent per task, with dependent video phases queued and the next worker started only after the previous worker has stopped and been reviewed.

  • remotion-best-practices routes all Remotion work when the exact mode is unclear.
  • remotion-create covers a new project or composition.
  • remotion-docs is required before relying on a current API or package detail.
  • remotion-markup covers composition markup, animation, layout, typography, media, audio, fonts, and timing.
  • remotion-studio opens a preview for visual inspection.
  • remotion-render covers explicit render requests or advanced rendering.

For 3D compositions, shared Blender/glTF assets, or video embedded in a website, also read three-and-web.md. Distinguish a live interactive scene, a parameterized Player, and an encoded video; implement and verify the surfaces actually requested, without migrating the host framework.

For review or planning, remain read-only. A skill workflow cannot authorize scaffolding, purchasing assets, uploading private media, deploying, or changing global configuration. Follow the user's language and the target project rules.

Also use motion only for web UI animation or a shared web surface. Remotion's frame timeline and Motion's browser runtime are compatible design ideas but not interchangeable APIs. Do not import motion/react into a Remotion composition just because the brief says “Motion”; choose based on the target runtime.

Establish the video contract

Before writing code, extract or reasonably assume:

  • audience, message, aspect ratio, duration, fps, and delivery format;
  • a scene list with purpose, entry/hold/exit beats, and approximate frame ranges;
  • visual system: type scale, palette, contrast, safe areas, media treatment;
  • editability: which props should be exposed as Composition inputs or Studio controls, and which values must remain stable for repeatable renders;
  • acceptance: key frames, transition points, preview route, and whether the user explicitly requested a rendered video file.

For every non-trivial animation, also record the brand and interaction contract: the feeling to convey, the product action or state being clarified, the visual motifs that must remain consistent, and the reference baseline or reason no compatible baseline was found.

When a task mentions one of these adjacent projects, verify its current official repository or documentation, version, command surface, and license before claiming that it was used. An ecosystem reference can inform the composition without changing the target runtime or adding an unrequested toolchain.

Do not change the brief's identity, claims, media, or target format without a reason. If content is a fixture, label it as fixture content in the handoff. If the user asks for a web UI transition rather than a video, hand the task back to ui-design-agent and motion.

Frame-first implementation

  • Use useCurrentFrame() and useVideoConfig() inside renderable components. Derive all time from frame and fps; never use wall-clock time, random state, timers, or unseeded randomness for visible output.
  • Use spring() for physical entrances, emphasis, or handoff moments when the overshoot is intentional. Use interpolate() for explicit keyframes and multi-stage paths. Provide durationInFrames or clamped ranges when the animation must end at a known frame.
  • Keep scene timing in a small, named contract. The same frame count has a different duration at 30fps and 60fps. Keep editable per-property keyframes inline when the current Studio interactivity workflow requires it; centralize shared scene durations without making those keyframes opaque to the editor.
  • Do not use wall-clock CSS transitions, CSS keyframes, Tailwind animation classes, or auto-playing browser animation timelines to drive rendered video. A requested GSAP integration must be explicitly seeked from the current frame through a supported integration, never allowed to free-run.
  • Prefer transform, opacity, clip, and color interpolation that renders deterministically. Use extrapolateLeft: 'clamp' and extrapolateRight: 'clamp' when a driver must not continue past its beat. Use Easing.step1 for intentionally discrete string changes.
  • Remotion's browser renderer can use DOM APIs. Do not depend on unguarded browser globals in Node-side code or module initialization. For necessary DOM measurement, read the official measurement guidance, account for preview scale, and wait for required fonts/assets before capture. The same frame and props must render the same output regardless of evaluation order.
  • Use staticFile() and Remotion media components for project assets. Resolve metadata before rendering when dimensions or duration are dynamic. Use delayRender() only for a real asynchronous dependency and always release it on success or cancelRender() on a bounded failure.
  • Keep important text inside the actual video safe area. Use deterministic line breaks or measured layout for long and localized copy. Never make essential information depend on hover, audio, or a transition completing.

Transitions

For adjacent scenes, prefer @remotion/transitions and TransitionSeries. Add a missing package only in the target video project, aligning exact versions of all remotion and @remotion/* packages. Verify official licensing for the intended usage; do not infer separate paid access from npm metadata alone. Use TransitionSeries.Sequence for scenes and put a single TransitionSeries.Transition or TransitionSeries.Overlay between them.

  • Choose the presentation from the edit: fade for continuity, slide or pushCut for directional movement, wipe for a reveal, flip for a deliberate spatial change, and more elaborate presentations only when the subject earns them. A short dissolve plus a well-matched hold is often more cinematic than a new effect on every cut.
  • Choose linearTiming for exact editorial control and springTiming when the transition should feel physical. Read current docs for the exact API and calculate duration in frames; do not guess from milliseconds.
  • A transition overlaps two scenes and shortens total duration. An overlay sits at the cut without shortening adjacent scenes. Do not place transitions or overlays adjacent to each other, exceed the previous or next sequence length, or leave scenes without a neighboring sequence.
  • Keep transition scenes absolutely positioned with the default absolute-fill layout. The scene must remain readable at the start and end of the overlap.
  • For a custom transition, first specify the outgoing/incoming property, progress range, z-order, and the fallback at progress 0 and 1. Reuse useTransitionProgress() or a documented presentation API when appropriate; do not invent a second timeline that can disagree with TransitionSeries.
  • The @remotion/transitions package is not the same as an arbitrary npm package named remotion-mcp. Do not use the deprecated Remotion MCP; use the installed official remotion-docs skill for current package guidance.

Sound design and delivery form

Sound is a layer of its own, not a garnish on the music bed. Author it on a separate track so it can be re-timed, ducked, and re-mixed independently of the score. See knowledge card video-sound-design-layer for the full parameter set and video-sixty-second-delivery-form for the duration matrix.

  • Three layers, three jobs: transition (a whoosh or riser marking the cut), emphasis (a click or pop on a number change or key word), rhythm (a subtle tick as UI elements enter). Do not let one layer do another's job.
  • Align every cue to its picture event within 2 frames. A sound that lands late reads as an editing mistake, not as style.
  • Keep the BGM under the effects: duck 3–6 dB on every cue with a short attack and release. Never bake effects into the music file — that makes re-cutting impossible.
  • Budget the density by length: roughly one cue per 4–5 seconds for a 2–3 minute cut, 12–20 cues for a 60-second cut. More than one per three seconds reads as cheap.
  • Effects must never carry information. Every claim stays readable with sound off; audio is enhancement, not a channel.
  • Write the cues down as data before writing audio code — a cue sheet with frame, track, sample, and why per row. The why is mandatory: a cue nobody can justify is noise. Validate the sheet against the composition's scene contract so drift is caught mechanically (scripts/sfx-check.mjs in the kit is the reference implementation).

Deliver a duration matrix rather than one cut: a hero (90–165s), a standard 60s ±5s, and a 30s ±5s social cut. All lengths share one narrative skeleton — hook, re-hooks, evidence — and differ only in how many information points they carry. A short cut is re-edited (reordered, re-trimmed to its own beats), never mechanically cropped from the hero. Give every length its own silent-readable first frame.

Studio, render, and evidence

Open Studio after a meaningful composition change and inspect the first frame, the hold, every transition midpoint, and the final frame. Check the actual requested delivery formats; do not add an unrequested aspect ratio. Check long copy, missing media, rapid prop changes, and audio/video boundaries when they are in scope.

Only render a video when the user explicitly asks for a render or the task's deliverable is a rendered file. Before rendering, run the project's typecheck, test, and bundle checks when present. For an explicit render, verify that the output exists, has the requested dimensions and duration, and can be opened; do not claim visual success from a zero-exit command alone. A Studio screenshot proves preview inspection, not a production render.

Respect reduced-motion language when the same composition is used in a Player or web preview. A video file itself cannot react to a viewer's media query after rendering, so if the request spans both contexts, define the distinction and provide a usable non-motion preview path.

Report the exact composition id, tested frame/fps assumptions, commands run, preview URL or output path, and any unverified media, browser, licensing, or rendering limitation. Never claim a transition is “frame-perfect”, “4K”, or “broadcast ready” without checking the corresponding artifact.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.