Skip to content
cccskills
FreePublished on GitHub

remotion-best-practices

Route Remotion tasks to the relevant specialist guides, from creating videos and projects to captions, maps, and rendering. It also guides Studio preview setup, package upgrades, and troubleshooting when working inside Codex.

OriginalShow the original description

Router for all Remotion skills

See how to install

Good for

  • Starting a new video or Remotion project
  • Finding guides for captions and animated maps
  • Previewing video edits in Remotion Studio
  • Finding guidance for rendering and package upgrades

Files included (127)

  • SKILL.md3.7 KB
  • agents/openai.yaml311 B
  • assets/remotion-icon.png1.3 KB
  • remotion-captions/agents/openai.yaml305 B
  • remotion-captions/assets/remotion-icon.png1.3 KB
  • remotion-captions/display-captions.md5.5 KB
  • remotion-captions/import-srt-captions.md2.2 KB
  • remotion-captions/REFERENCE.md982 B
  • remotion-captions/transcribe-captions.md1.9 KB
  • remotion-create/agents/openai.yaml310 B
  • remotion-create/assets/remotion-icon.png1.3 KB
  • remotion-create/REFERENCE.md2.7 KB
  • remotion-create/tailwind.md386 B
  • remotion-create/video-layout.md498 B
  • remotion-docs/agents/openai.yaml307 B
  • remotion-docs/assets/remotion-icon.png1.3 KB
  • remotion-docs/REFERENCE.md1.3 KB
  • remotion-interactivity/agents/openai.yaml320 B
  • remotion-interactivity/assets/remotion-icon.png1.3 KB
  • remotion-interactivity/REFERENCE.md9.5 KB
  • remotion-maps/agents/openai.yaml293 B
  • remotion-maps/assets/remotion-icon.png1.3 KB
  • remotion-maps/REFERENCE.md1.0 KB
  • remotion-maps/techniques/cesium/assets/cesium-path.json12.0 KB
  • remotion-maps/techniques/cesium/assets/city-path.json223 B
  • remotion-maps/techniques/cesium/assets/flight-path.ts1.2 KB
  • remotion-maps/techniques/cesium/assets/sample-river.geojson6.3 KB
  • remotion-maps/techniques/cesium/references/3d-data-sources.md1.4 KB
  • remotion-maps/techniques/cesium/references/3d-flyover-architecture.md7.7 KB
  • remotion-maps/techniques/cesium/references/3d-troubleshooting.md6.6 KB
  • remotion-maps/techniques/cesium/scripts/prep-cesium-path.mjs5.4 KB
  • remotion-maps/techniques/cesium/TECHNIQUE.md3.8 KB
  • remotion-maps/techniques/mapbox/references/render-stability.md3.6 KB
  • remotion-maps/techniques/mapbox/TECHNIQUE.md12.9 KB
  • remotion-maps/techniques/maplibre/references/render-stability.md3.6 KB
  • remotion-maps/techniques/maplibre/TECHNIQUE.md13.6 KB
  • remotion-maps/techniques/maptiler/assets/MapTilerVectorElement.ts2.1 KB
  • remotion-maps/techniques/maptiler/assets/sample-data/country-meta.json325.3 KB
  • remotion-maps/techniques/maptiler/assets/sample-data/yarlung-flow.json12.8 KB
  • remotion-maps/techniques/maptiler/assets/tokens.ts1.2 KB
  • remotion-maps/techniques/maptiler/references/map-data-sources.md4.7 KB
  • remotion-maps/techniques/maptiler/references/map-explainer-architecture.md6.7 KB
  • remotion-maps/techniques/maptiler/references/map-geo-prep.md4.0 KB
  • remotion-maps/techniques/maptiler/references/render-stability.md3.6 KB
  • remotion-maps/techniques/maptiler/scripts/prep-geo.mjs7.4 KB
  • remotion-maps/techniques/maptiler/TECHNIQUE.md4.4 KB
  • remotion-maps/techniques/static-map/TECHNIQUE.md1.1 KB
  • remotion-markup/3d.md2.2 KB
  • remotion-markup/agents/openai.yaml310 B
  • remotion-markup/assets/remotion-icon.png1.3 KB
  • remotion-markup/audio-visualization.md4.8 KB
  • remotion-markup/audio.md3.7 KB
  • remotion-markup/calculate-metadata.md3.4 KB
  • remotion-markup/compositions.md3.1 KB
  • remotion-markup/cropping.md1.1 KB
  • remotion-markup/effects.md8.7 KB
  • remotion-markup/embedding-videos.md3.4 KB
  • remotion-markup/ffmpeg.md1.1 KB
  • remotion-markup/gifs.md3.7 KB
  • remotion-markup/google-fonts.md1.7 KB
  • remotion-markup/html-in-canvas.md2.9 KB
  • remotion-markup/images.md1.4 KB
  • remotion-markup/light-leaks.md3.1 KB
  • remotion-markup/local-fonts.md1.5 KB
  • remotion-markup/lottie.md1.8 KB
  • remotion-markup/measuring-dom-nodes.md995 B
  • remotion-markup/measuring-text.md2.7 KB
  • remotion-markup/multi-scene-video.md2.0 KB
  • remotion-markup/parameters.md2.3 KB
  • remotion-markup/REFERENCE.md11.3 KB
  • remotion-markup/remotion-maps/agents/openai.yaml293 B
  • remotion-markup/remotion-maps/assets/remotion-icon.png1.3 KB
  • remotion-markup/remotion-maps/REFERENCE.md1.0 KB
  • remotion-markup/remotion-maps/techniques/cesium/assets/cesium-path.json12.0 KB
  • remotion-markup/remotion-maps/techniques/cesium/assets/city-path.json223 B
  • remotion-markup/remotion-maps/techniques/cesium/assets/flight-path.ts1.2 KB
  • remotion-markup/remotion-maps/techniques/cesium/assets/sample-river.geojson6.3 KB
  • remotion-markup/remotion-maps/techniques/cesium/references/3d-data-sources.md1.4 KB
  • remotion-markup/remotion-maps/techniques/cesium/references/3d-flyover-architecture.md7.7 KB
  • remotion-markup/remotion-maps/techniques/cesium/references/3d-troubleshooting.md6.6 KB
  • remotion-markup/remotion-maps/techniques/cesium/scripts/prep-cesium-path.mjs5.4 KB
  • remotion-markup/remotion-maps/techniques/cesium/TECHNIQUE.md3.8 KB
  • remotion-markup/remotion-maps/techniques/mapbox/references/render-stability.md3.6 KB
  • remotion-markup/remotion-maps/techniques/mapbox/TECHNIQUE.md12.9 KB
  • remotion-markup/remotion-maps/techniques/maplibre/references/render-stability.md3.6 KB
  • remotion-markup/remotion-maps/techniques/maplibre/TECHNIQUE.md13.6 KB
  • remotion-markup/remotion-maps/techniques/maptiler/assets/MapTilerVectorElement.ts2.1 KB
  • remotion-markup/remotion-maps/techniques/maptiler/assets/sample-data/country-meta.json325.3 KB
  • remotion-markup/remotion-maps/techniques/maptiler/assets/sample-data/yarlung-flow.json12.8 KB
  • remotion-markup/remotion-maps/techniques/maptiler/assets/tokens.ts1.2 KB
  • remotion-markup/remotion-maps/techniques/maptiler/references/map-data-sources.md4.7 KB
  • remotion-markup/remotion-maps/techniques/maptiler/references/map-explainer-architecture.md6.7 KB
  • remotion-markup/remotion-maps/techniques/maptiler/references/map-geo-prep.md4.0 KB
  • remotion-markup/remotion-maps/techniques/maptiler/references/render-stability.md3.6 KB
  • remotion-markup/remotion-maps/techniques/maptiler/scripts/prep-geo.mjs7.4 KB
  • remotion-markup/remotion-maps/techniques/maptiler/TECHNIQUE.md4.4 KB
  • remotion-markup/remotion-maps/techniques/static-map/TECHNIQUE.md1.1 KB
  • remotion-markup/sequencing.md3.9 KB
  • remotion-markup/sfx.md1.8 KB
  • remotion-markup/silence-detection.md2.5 KB
  • remotion-markup/text-highlights.md1.8 KB
  • remotion-markup/timing.md3.2 KB
  • remotion-markup/transitions.md6.7 KB
  • remotion-markup/video-editing.md3.3 KB
  • remotion-markup/voiceover.md3.3 KB
  • remotion-multimedia/agents/openai.yaml317 B
  • remotion-multimedia/assets/remotion-icon.png1.3 KB
  • remotion-multimedia/get-audio-duration.md1.3 KB
  • remotion-multimedia/get-video-dimensions.md1.5 KB
  • remotion-multimedia/get-video-duration.md1.3 KB
  • remotion-multimedia/REFERENCE.md705 B
  • remotion-render/agents/openai.yaml286 B
  • remotion-render/assets/remotion-icon.png1.3 KB
  • remotion-render/REFERENCE.md470 B
  • remotion-render/transparent-videos.md2.2 KB
  • remotion-saas/agents/openai.yaml283 B
  • remotion-saas/assets/remotion-icon.png1.3 KB
  • remotion-saas/framework.md908 B
  • remotion-saas/player.md942 B
  • remotion-saas/REFERENCE.md1.0 KB
  • remotion-saas/rendering.md3.3 KB
  • remotion-studio/agents/openai.yaml237 B
  • remotion-studio/assets/remotion-icon.png1.3 KB
  • remotion-studio/REFERENCE.md1.6 KB
  • remotion-upgrade/agents/openai.yaml282 B
  • remotion-upgrade/assets/remotion-icon.png1.3 KB
  • remotion-upgrade/REFERENCE.md1.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

Rendering

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

Opening Remotion Studio

When creating or editing a video, start Studio and open its preview as soon as the project can run, before building the composition. Keep it open while you work so the user can see changes and steer.

To launch a project in Remotion Studio, open its exact local URL, or configure Studio CLI flags, load Remotion Studio.

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.

Codex troubleshooting

When running inside Codex, first try starting the Remotion Studio without opening the system browser:

npx remotion studio --no-open

Open the exact printed URL in the Codex 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.

Only if that fails with file watcher limits such as EMFILE: too many open files, watch, retry with polling and without opening a browser from Codex:

npx remotion studio --no-open --webpack-poll 1000

After retrying, open the exact printed URL in the Codex in-app browser and verify that Studio loads. Once a composition exists, verify that its video preview loads. If you cannot open it there, retry without --no-open.

If Studio still fails to start from Codex, ask the user to start it manually from their macOS Terminal and then continue using the already-running Studio. Sandbox errors while launching Chromium from Codex are likely caused by the Codex/macOS sandbox rather than the Remotion project.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

add-bug

FreeSummary

Add a reported Remotion bug to the bugs API with its affected versions, a short title, and upgrade guidance. Follow the existing entry format and place the new record first so recent bugs appear at the top.

  • Adding a reported bug to the Remotion bugs API
  • Recording which versions a bug affects
  • Including upgrade guidance in a bug description
remotion-dev/remotion65KUpdated Oct 18, 2026

add-cli-option

FreeSummary

Add a Remotion command-line or configuration option, or convert a hardcoded flag into a shared option definition. Connect parsing, configuration setters, help entries, and generated documentation so the option is consistently available and documented.

  • Add a new Remotion command-line flag
  • Convert a hardcoded flag into a shared option
  • Connect an option to Config setters
remotion-dev/remotion65KUpdated Oct 18, 2026

add-effect

FreeSummary

Add a new effect to @remotion/effects, including its implementation, package entry points, documentation, interactive demo, and preview images. Follow the package conventions and verify the changes with tests, formatting checks, and builds.

  • Implementing a new effect for @remotion/effects
  • Registering effect imports and parameter types
  • Creating documentation and an interactive effect demo
remotion-dev/remotion65KUpdated Oct 18, 2026

add-expert

FreeSummary

Add a person to the Remotion experts page by placing their portrait, entering their profile and contact links, and generating an expert card image. The instructions specify file locations, profile fields, and how to verify card generation.

  • Add a new person to the Remotion experts page
  • Register a portrait, specialties, and contact links
  • Generate an expert card image
remotion-dev/remotion65KUpdated Oct 18, 2026

add-new-package

FreeSummary

Create a new @remotion package within the Remotion monorepo, a repository containing multiple packages. Set up its files, register it across the project, and prepare documentation, usage examples, and build configuration.

  • Creating a new @remotion package
  • Registering a package across the monorepo
  • Adding documentation and usage examples
remotion-dev/remotion65KUpdated Oct 18, 2026

add-sfx

FreeSummary

Add a new sound effect to @remotion/sfx, from registering the audio file to exporting its URL and documenting its use. The workflow covers playback examples, attribution, navigation entries, waveform generation, and the package build.

  • Add a sound effect to @remotion/sfx
  • Create documentation with playback and usage examples
  • Update sound effect navigation and waveform data
remotion-dev/remotion65KUpdated Oct 18, 2026

See all skills by remotion-dev

Report a problem with this skill