FreePublished on GitHub

remotion-best-practices

Router for all Remotion skills

The English summary is being prepared. Showing the original description.

remotion-dev/codex-plugin

See how to install

Files included (134)

SKILL.md4.5 KB
agents/openai.yaml311 B
assets/remotion-icon.svg1.3 KB
remotion-captions/agents/openai.yaml305 B
remotion-captions/assets/remotion-icon.svg1.3 KB
remotion-captions/display-captions.md5.8 KB
remotion-captions/import-srt-captions.md2.2 KB
remotion-captions/REFERENCE.md1.1 KB
remotion-captions/transcribe-captions.md5.4 KB
remotion-create/agents/openai.yaml310 B
remotion-create/assets/remotion-icon.svg1.3 KB
remotion-create/REFERENCE.md2.9 KB
remotion-create/tailwind.md386 B
remotion-create/video-layout.md498 B
remotion-docs/agents/openai.yaml307 B
remotion-docs/assets/remotion-icon.svg1.3 KB
remotion-docs/REFERENCE.md1.3 KB
remotion-interactivity/agents/openai.yaml320 B
remotion-interactivity/assets/remotion-icon.svg1.3 KB
remotion-interactivity/inline-effects.md993 B
remotion-interactivity/REFERENCE.md13.5 KB
remotion-interactivity/timeline-structure.md6.9 KB
remotion-maps/agents/openai.yaml293 B
remotion-maps/assets/remotion-icon.svg1.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.8 KB
remotion-maps/techniques/maplibre/references/render-stability.md3.6 KB
remotion-maps/techniques/maplibre/TECHNIQUE.md13.5 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/arabic-text.md4.4 KB
remotion-markup/assets/remotion-icon.svg1.3 KB
remotion-markup/audio-visualization.md4.8 KB
remotion-markup/audio.md4.0 KB
remotion-markup/calculate-metadata.md3.4 KB
remotion-markup/color-correction.md4.3 KB
remotion-markup/compositions.md5.0 KB
remotion-markup/connected-compositions.md3.4 KB
remotion-markup/cropping.md1.3 KB
remotion-markup/effects.md10.6 KB
remotion-markup/embedding-videos.md3.6 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.5 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/motion-blur.md2.0 KB
remotion-markup/multi-scene-video.md1.0 KB
remotion-markup/parameters.md2.3 KB
remotion-markup/REFERENCE.md12.8 KB
remotion-markup/remotion-maps/agents/openai.yaml293 B
remotion-markup/remotion-maps/assets/remotion-icon.svg1.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.8 KB
remotion-markup/remotion-maps/techniques/maplibre/references/render-stability.md3.6 KB
remotion-markup/remotion-maps/techniques/maplibre/TECHNIQUE.md13.5 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.md1.3 KB
remotion-markup/sfx.md1.8 KB
remotion-markup/silence-detection.md2.5 KB
remotion-markup/text-highlights.md1.8 KB
remotion-markup/timing-props.md3.3 KB
remotion-markup/timing.md3.2 KB
remotion-markup/transitions.md8.6 KB
remotion-markup/video-editing.md5.7 KB
remotion-markup/voiceover.md3.6 KB
remotion-multimedia/agents/openai.yaml317 B
remotion-multimedia/assets/remotion-icon.svg1.3 KB
remotion-multimedia/get-audio-duration.md1.5 KB
remotion-multimedia/get-video-dimensions.md1.8 KB
remotion-multimedia/get-video-duration.md1.4 KB
remotion-multimedia/REFERENCE.md705 B
remotion-render/agents/openai.yaml286 B
remotion-render/assets/remotion-icon.svg1.3 KB
remotion-render/REFERENCE.md711 B
remotion-render/transparent-videos.md2.2 KB
remotion-saas/agents/openai.yaml283 B
remotion-saas/assets/remotion-icon.svg1.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.svg1.3 KB
remotion-studio/REFERENCE.md1.6 KB
remotion-upgrade/agents/openai.yaml282 B
remotion-upgrade/assets/remotion-icon.svg1.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

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.

To start the preview server by default without opening the system browser, pass --no-open:

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. Open the exact URL in the Codex in-app browser. Verify that Studio loads. Once a composition exists, verify that its video preview loads. If the in-app browser is not available, keep the preview server running and provide the URL to the user. You can visit a specific composition by navigating to /[composition-id], for example http://localhost:3000/MapAnimation.

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

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.

Codex troubleshooting

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

npx remotion studio --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

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.

More skills from this repository

remotion-captions

Free

Transcribing, displaying and animating captions

The English summary is being prepared. Showing the original description.

remotion-dev/codex-plugin26Updated Oct 20, 2026

remotion-create

Free

Create a new Remotion video

The English summary is being prepared. Showing the original description.

remotion-dev/codex-plugin26Updated Oct 20, 2026

remotion-docs

Free

Search Remotion documentation

The English summary is being prepared. Showing the original description.

remotion-dev/codex-plugin26Updated Oct 20, 2026

remotion-interactivity

Free

Structure Remotion markup for interactivity

The English summary is being prepared. Showing the original description.

remotion-dev/codex-plugin26Updated Oct 20, 2026

remotion-maps

Free

Remotion Map animation knowledge

The English summary is being prepared. Showing the original description.

remotion-dev/codex-plugin26Updated Oct 20, 2026

remotion-markup

Free

Content, animation and effects best practices

The English summary is being prepared. Showing the original description.

remotion-dev/codex-plugin26Updated Oct 20, 2026

See all skills by remotion-dev

Report a problem with this skill

Install

Install with a command

npx skills add https://github.com/remotion-dev/codex-plugin --skill remotion-best-practices

Paste it into your terminal and run it (requires Node.js). You can choose which agents to install it for, such as Claude Code or Codex.

Ask your agent

Please install the following Agent Skill.
https://github.com/remotion-dev/codex-plugin/tree/main/skills/remotion-best-practices

First review SKILL.md and the bundled files and confirm there is nothing suspicious (such as sending data externally or reading credentials). Then place it in ~/.claude/skills/remotion-best-practices/ for Claude Code, or ~/.agents/skills/remotion-best-practices/ for Codex.

Send this text to Claude Code or Codex as is. It checks the contents before installing.

View source on GitHub

Repository: remotion-dev/codex-plugin
Stars: 26
Forks: 2
Category: Other
License: MIT
Original language: English
Last updated: Oct 20, 2026

A skill is a set of instructions and scripts for an agent. cccskills does not guarantee that skills are safe. Review the contents before you install.