Skip to content
Remotion Best Practices

Remotion Best Practices Skill

Remotion's official router skill for making videos in React: it sends the agent to the right Remotion reference for new projects, markup, captions, maps, rendering, SaaS apps and docs.

GitHub Docs
DevelopmentDesign & Creative
Released
v4.0.543
Remotion License

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-best-practices

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-best-practices/, 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-best-practices ~/.claude/skills/remotion-best-practices

No scripts or references next to it? Saving the SKILL.md alone as ~/.claude/skills/remotion-best-practices/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

  • Routes each task to the matching Remotion reference
  • Opens Remotion Studio for a live preview before building
  • Renders only when you explicitly ask for an export
  • Covers captions, maps, multimedia, SaaS rendering, licensing and upgrades

Remotion Best Practices is the entry-point skill published by the Remotion team for agents that build videos with Remotion, the framework for creating video programmatically in React. It is a router: rather than holding everything itself, it tells the agent which bundled reference to load for the task at hand.

Asking to make a new video or composition loads the project-creation guide; writing Remotion markup loads the markup best practices; maps and animated routes (Mapbox, MapLibre, MapTiler, GeoJSON) load the maps reference; trimming, cropping and metadata go to multimedia, video matting and background removal to markup, captions to the captions guide, and Player, Lambda, Vercel, Cloudflare or Express rendering to the SaaS reference. Further references cover Studio, documentation lookup, licensing and upgrades.

It also sets working habits. The agent should respect edits you make outside the conversation instead of overwriting them, open Remotion Studio for an interactive preview as soon as the project runs (with instructions for Cursor, agents with an in-app browser and those without), and render an MP4 only when you explicitly ask. Remotion is source-available under the Remotion License, which requires a paid company licence for some commercial use; the skill points to the licensing reference for details.

SKILL.md

The instructions your agent loads, as published by Remotion.

SKILL.md
name
remotion-best-practices
description
Router for all Remotion skills
version
4.0.543
Preserve user changes

Users may make edits in the code outside of the conversation.

If you detect a surprising change made in the meanwhile, don't overwrite it, assume it was intentional or ask for confirmation.

Creating a video

If the user asks to make, create, or build a new video or composition, load [Create a new Remotion video](./remotion-create/REFERENCE.md), whether or not a Remotion project already exists.

New project setup

If no Remotion project currently exists, load [Create a new Remotion project](./remotion-create/REFERENCE.md)

React Markup Best Practices

If you are writing Remotion React Markup, load [Remotion Markup Best Practices](./remotion-markup/REFERENCE.md)

Maps

For static maps, animated routes and markers, geographic explainers, Mapbox, MapLibre, MapTiler, GeoJSON, or 3D geographic flyovers, load [Remotion Maps](./remotion-maps/REFERENCE.md).

Multimedia

For achieving multimedia tasks in the browser, such as trimming, cropping videos, or getting metadata from them, load [Remotion Multimedia](./remotion-multimedia/REFERENCE.md)

For video matting, background removal, or placing content behind a subject,
load [Remotion Markup](./remotion-markup/REFERENCE.md).

Interactivity

New markup is editable in Studio by default. When writing or restructuring markup, load [Interactivity Best Practices](./remotion-interactivity/REFERENCE.md).

Open the preview

If the user asks to "make" a video, "create" a video, etc.
Don't render the video by default unless they are very explicit. They want to instead see an interactive preview.
As soon as the project can run, start Studio and open the preview in the browser before building or editing the composition. Keep it open while you work so the user can watch progress and steer.

If you are using Cursor

Run Studio without --no-open so it opens the browser automatically:

npx remotion studio
If you are using another agent client with an in-app browser

You can use the command above to let Studio open the browser, or run:

npx remotion studio --no-open

This will start a long-running process and print the server URL for the preview.
If the server is already started, it will print the URL.
If you use --no-open, open the exact printed URL in the in-app browser and verify that Studio loads. Once a composition exists, verify that its video preview loads. If you cannot open it there, run Studio without --no-open.
You can visit a specific composition by navigating to /[composition-id], for example http://localhost:3000/MapAnimation.

:::note
The Studio supports WebMCP tools.
:::

If you do not have an in-app browser

This will open the Studio in the browser or refocus it if it is already open.

npx remotion studio
More options

To launch a project in Remotion Studio, open its exact local URL, or configure Studio CLI flags, load [Remotion Studio](./remotion-studio/REFERENCE.md).

Render the video

Only render if the user is very explicit in asking for it.
E.g. "Render the video", "Export", "Give me the MP4".

The preview also has a more intuitive rendering interface, so consider using it instead of the command line for rendering.

npx remotion render

For more options, see [Rendering](./remotion-render/REFERENCE.md).

For advanced rendering beyond simple npx remotion render, see: [Rendering Best Practices](./remotion-render/REFERENCE.md)

Captions

When working with Captions, load [Remotion Captions](./remotion-captions/REFERENCE.md).

Creating a SaaS, automation or application

Use the [Remotion SaaS skill](./remotion-saas/REFERENCE.md) for knowledge about Remotion-powered SaaS apps, such as <Player>, rendering on Lambda, Vercel, Cloudflare, via Express.js, client-side rendering, or for finding the right SaaS template.

Looking up Remotion APIs and documentation

To find and read current Remotion documentation, load [Remotion Docs](./remotion-docs/REFERENCE.md).

Licensing

For Remotion license information, FAQs, terms, or buying a license, load [Remotion License](./remotion-license/REFERENCE.md).

Upgrading

To upgrade Remotion, related packages, compatible Mediabunny packages, and installed Remotion Agent Skills, load [Remotion Upgrade](./remotion-upgrade/REFERENCE.md).

Install
New

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.

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 →