Skip to content
Remotion Render

Remotion Render Skill

Remotion's official skill for exporting a Remotion video: npx remotion render and still, input props, license keys and free-license renders, frame sequences and transparent video output.

GitHub Docs

Install

Install with the skills CLI

One command for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf and dozens of other agents. Needs Node.js; the skill is fetched straight from remotion-dev/skills.

$ npx skills add remotion-dev/skills --skill remotion-render

Run it in a terminal. The CLI finds the agents installed on your machine, asks which ones to add the skill to, and whether to install it into the folder you ran it from or for all your projects.

Other ways to install

Copy the whole skill folder — SKILL.md and any scripts or references beside it — into ~/.claude/skills/remotion-render/, where Claude Code picks it up in every project. Only git is needed.

tmp=$(mktemp -d) && \
  git clone --depth 1 --branch main https://github.com/remotion-dev/skills.git "$tmp" && \
  mkdir -p ~/.claude/skills && \
  cp -R "$tmp"/skills/remotion-render ~/.claude/skills/remotion-render

No scripts or references next to it? Saving the SKILL.md alone as ~/.claude/skills/remotion-render/SKILL.md works too.

Using another agent? Its personal skills folder
Codex
~/.agents/skills/
Cursor
~/.cursor/skills/
GitHub Copilot
~/.copilot/skills/
Gemini CLI
~/.gemini/skills/
Windsurf
~/.codeium/windsurf/skills/
OpenCode
~/.config/opencode/skills/

About

  • Uses Remotion's bundled browser for reliable renders
  • Input props as inline JSON or a JSON file, merged over defaultProps
  • License key handling, free-license and non-billed test renders
  • Stills and multi-frame image export with predictable filenames
  • Linked guide for transparent video output

Remotion Render is the export step in Remotion's official skill set for making videos with React. Once a composition exists, this skill tells a coding agent how to turn it into a file with the Remotion CLI and avoid the mistakes that make renders fail or bill unexpectedly.

It sets a rendering strategy first: use Remotion's bundled browser, which includes the browser APIs and fixes Remotion depends on (including for compositions using <HtmlInCanvas>), and let Remotion download or update it, rather than pointing the render at another browser executable unless the user asks for one. Videos render with npx remotion render, with links to the full option list.

Input props can be passed as inline JSON or as a path to a JSON file and are shallow-merged over the composition's defaultProps. The licensing section explains that companies that need a Remotion company license should pass their key to every render, that people who qualify for the free license pass free-license, that an empty key is invalid, and that test renders should add --is-production=false so they are not billed.

Stills render with npx remotion still. Several frames can be exported as images in one call with render --frames, and the skill documents how Remotion zero-pads the output filenames so the agent lists the folder rather than guessing names. A linked reference covers rendering video with transparency.

The skill is distributed under the Remotion License, versioned with Remotion (4.0.543 at the time of listing).

SKILL.md

The instructions your agent loads, as published by Remotion.

SKILL.md
name
remotion-render
description
Export a Remotion video
version
4.0.543
General rendering strategy

Use Remotion's bundled browser for rendering, including compositions using
<HtmlInCanvas>. It includes the required browser APIs and Remotion's browser
fixes. Let Remotion download or update it as needed. Do not reuse a recording
browser or set --browser-executable, browserExecutable, or chromeMode
unless the user explicitly requests a different browser.

Render a video using:

npx remotion render

Full list of options: https://www.remotion.dev/docs/cli/render.md

Passing input props

Pass input props as inline JSON or as a path to a JSON file:

npx remotion render [composition-id] out/video.mp4 --props='{"title": "Hello"}'
npx remotion render [composition-id] out/video.mp4 --props=./props.json

Remotion shallow-merges input props over the defaultProps of the composition.
See https://www.remotion.dev/docs/passing-props.md.

License key

Companies that need a Remotion license (remotion-license skill) should
pass their license key to every render. If the user qualifies for the free
license, pass free-license instead:

npx remotion render [composition-id] out/video.mp4 --license-key=$REMOTION_PRIVATE_LICENSE_KEY

Only pass --license-key if a key is available, since an empty value is not a valid key.
Add --is-production=false for test renders so that Remotion does not bill them.
See https://www.remotion.dev/docs/telemetry.md.

Render a still using:

npx remotion still

Full list of options: https://www.remotion.dev/docs/cli/still.md

To render several frames as images in one call, use render --frames:

npx remotion render [composition-id] out/frames --frames=0,30,90 --image-format=png

See https://www.remotion.dev/docs/cli/render.md#--frames for more options.

Remotion writes the frames as element-[frame].[ext]. It pads the frame number
with zeros to the number of digits of the highest rendered frame, so
--frames=4,30 writes element-04.png and element-30.png. List the output
folder instead of guessing the filenames, or pass --image-sequence-pattern
to change the pattern.

Transparent videos

See [Transparent videos](./transparent-videos.md) for rendering out a video with transparency.

Install
New

Remotion's official skill for writing the React markup of a video: frame-driven animation with interpolate(), Studio-editable timing, media components, built-in visual effects, transitions, captions and fonts.

New

Remotion's official skill for captions in programmatic videos: it holds the agent to the @remotion/captions Caption type and routes it to guides for transcribing audio, rendering animated captions and importing .srt files.

Browse all skills →