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
- frankxai/awesome-motion-design-agent-skillstheir own version, first seen Nov 5, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- frankxai/awesome-motion-design-agent-skills★ 111same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository26 other files it gives its agents.
- AGENTS.mdAGENTS.md
- anatomySkill
- gsap-coreSkill
- gsap-frameworksSkill
- gsap-performanceSkill
- gsap-pluginsSkill
- gsap-reactSkill
- gsap-scrolltriggerSkill
- gsap-timelineSkill
- gsap-utilsSkill
- jiejoe-designSkill
- motionSkill
- promotion-playbookSkill
- remotion-best-practicesSkill
- remotion-captionsSkill
- remotion-createSkill
- remotion-docsSkill
- remotion-interactivitySkill
- remotion-markupSkill
- remotion-multimediaSkill
- remotion-renderSkill
- remotion-studioSkill
- uak-design-systemSkill
- uak-design-thinkingSkill
- uak-visual-critiqueSkill
- ui-design-agentSkill
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
- Distinctive: line 20
When a comparable treatment exists, search official examples and mature open-source projects first and adapt a named, inspectable baseline.
- Distinctive: line 24
Use the surrounding open-source ecosystem as a deliberate comparison set: Remotion is the default for React and frame-accurate web …
- Distinctive: line 35
Read workflow.md for the relevant mode and load only the official Remotion skill needed for the current request:
- Distinctive: line 38
When this route is dispatched by a main agent, follow the kit's bounded concurrency policy: one active subagent per task, with dependent …
- Distinctive: line 67
Before writing code, extract or reasonably assume:
- Distinctive: line 82
When a task mentions one of these adjacent projects, verify its current official repository or documentation, version, command surface, and …
- Distinctive: line 87
Do not change the brief's identity, claims, media, or target format without a reason.
- Very specific: line 89
If the user asks for a web UI transition rather than a video, hand the task back to ui-design-agent and motion.
- Very specific: line 94
Use useCurrentFrame() and useVideoConfig() inside renderable components.
- Very specific: line 97
Use spring() for physical entrances, emphasis, or handoff moments when the overshoot is intentional.
- Distinctive: line 101
Keep scene timing in a small, named contract.
- Distinctive: line 105
Do not use wall-clock CSS transitions, CSS keyframes, Tailwind animation classes, or auto-playing browser animation timelines to drive …
- Very specific: line 109
Prefer transform, opacity, clip, and color interpolation that renders deterministically.
- Very specific: line 112
Use Easing.step1 for intentionally discrete string changes.
- Very specific: line 118
Use staticFile() and Remotion media components for project assets.
- Distinctive: line 122
Keep important text inside the actual video safe area.
- Very specific: line 129
Add a missing package only in the target video project, aligning exact versions of all remotion and @remotion/* packages.
- Very specific: line 132
Use TransitionSeries.Sequence for scenes and put a single TransitionSeries.Transition or TransitionSeries.Overlay between them.
- Distinctive: line 147
Keep transition scenes absolutely positioned with the default absolute-fill layout.
- Distinctive: line 169
Keep the BGM under the effects: duck 3–6 dB on every cue with a short attack and release.
- Very specific: line 177
Write the cues down as data before writing audio code — a cue sheet with frame, track, sample, and why per row.
- Distinctive: line 198
Only render a video when the user explicitly asks for a render or the task's deliverable is a rendered file.
≈ “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.
Files
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-practicesroutes all Remotion work when the exact mode is unclear.remotion-createcovers a new project or composition.remotion-docsis required before relying on a current API or package detail.remotion-markupcovers composition markup, animation, layout, typography, media, audio, fonts, and timing.remotion-studioopens a preview for visual inspection.remotion-rendercovers 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
Compositioninputs 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()anduseVideoConfig()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. Useinterpolate()for explicit keyframes and multi-stage paths. ProvidedurationInFramesor 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'andextrapolateRight: 'clamp'when a driver must not continue past its beat. UseEasing.step1for 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. UsedelayRender()only for a real asynchronous dependency and always release it on success orcancelRender()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:
fadefor continuity,slideorpushCutfor directional movement,wipefor a reveal,flipfor 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
linearTimingfor exact editorial control andspringTimingwhen 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 withTransitionSeries. - The
@remotion/transitionspackage is not the same as an arbitrary npm package namedremotion-mcp. Do not use the deprecated Remotion MCP; use the installed officialremotion-docsskill 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, andwhyper 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.mjsin 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.
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
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.

