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

remotion-best-practices

Skill23 starsChanged 27 days agoApache-2.0View on GitHub

Router for all Remotion skills

161 other projects use a version of this, 43 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use canvas-procedural-animation, ltx2 and 4 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • LinHao-citySkill

    canvas-procedural-animation

    Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

    Also in 5 projects that use this

  • LinHao-citySkill

    ltx2

    AI video generation with LTX-2.3 22B — text-to-video, image-to-video clips for video production. Use when generating video clips, animating images, creating b-roll, animated backgrounds, or motion content. Triggers include video generation, animate image, b-roll, motion, video clip, text-to-video, image-to-video.

    Also in 7 projects that use this

  • mia-cxSkill

    remotion-license

    Find Remotion license information, FAQs, terms, and where to buy a license.

    Also in 5 projects that use this

  • OpenAISkill

    remotion-saas

    Build an app with Remotion

    Also in 26 projects that use this

  • OpenAISkill

    remotion-maps

    Remotion Map animation knowledge

    Also in 22 projects that use this

  • +1 more from LinHao-city

The file

We split this skill into the rules it gives an agent

12 rules. 0 are common, 8 are distinctive, and 4 are very specific to this project.

  • 0

    Common

    Most of the 158 edited versions we read keep these.

  • 8

    Distinctive

    This author's own choices. Worth a look.

  • 4

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

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

    line 12
  2. Distinctive:

    If the user asks to make, create, or build a new video or composition, load Create a new Remotion video, whether or not a Remotion project …

    line 16
  3. Distinctive:

    If no Remotion project currently exists, load Create a new Remotion project

    line 20
  4. Distinctive:

    If you are writing Remotion React Markup, load Remotion Markup Best Practices

    line 24
  5. Distinctive:

    If the user asks to "make" a video, "create" a video, etc.

    line 40
  6. Distinctive:

    Don't render the video by default unless they are very explicit.

    line 41
  7. Very specific:

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

    line 46
  8. Very specific:

    If the server is already started, it will print the URL.

    line 61
  9. Very specific:

    If you use --no-open, open the exact printed URL in the in-app browser and verify that Studio loads.

    line 62
  10. Distinctive:

    Only render if the user is very explicit in asking for it.

    line 83
  11. Distinctive:

    When working with Captions, load Remotion Captions.

    line 98
  12. Very specific:

    Use the Remotion SaaS skill for knowledge about Remotion-powered SaaS apps, such as <Player>, rendering on Lambda, Vercel, Cloudflare, via …

    line 102

“Common” is measured: kept by at least 6 in 10 of the 158 edited versions of this file we could read. “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

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, whether or not a Remotion project already exists.

New project setup

If no Remotion project currently exists, load Create a new Remotion project

React Markup Best Practices

If you are writing Remotion React Markup, load Remotion Markup Best Practices

Maps

For static maps, animated routes and markers, geographic explainers, Mapbox, MapLibre, MapTiler, GeoJSON, or 3D geographic flyovers, load Remotion Maps.

Multimedia

For achieving multimedia tasks in the browser, such as trimming, cropping videos, or getting metadata from them, load Remotion Multimedia

Improving Interactivity

By structuring the Remotion markup well, we can allow users to interactively change things in the Studio and write back to code. If relevant: Interactivity Best Practices

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.

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.

For advanced rendering beyond simple npx remotion render, see: Rendering Best Practices

Captions

When working with Captions, load Remotion Captions.

Creating a SaaS, automation or application

Use the Remotion SaaS skill 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.

Upgrading

To upgrade Remotion, related packages, compatible Mediabunny packages, and installed Remotion Agent Skills, load Remotion Upgrade.

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.