skills / remotion-dev / skills / remotion-best-practices
Remotion Best Practices
A verified Remotion skill with practical rules for composition structure, subtitles, and FFmpeg-backed video operations in React-based render pipelines.
Source description: Best practices for Remotion - Video creation in React
npx skills add https://github.com/remotion-dev/skills --skill remotion-best-practicesOn this page
Our added value (verification layer)
This page is not only a source mirror. We add reproducibility, risk controls, and operations guidance on top of the original skill definition.
- Execution/Security/Maintainability scoring with explicit criteria
- Compatibility matrix across runtime environments
- Verification log with check commands and observed outcomes
- Common failure fixes and rollback triggers for production safety
Overall score
81/100
Execution
84
Security
77
Maintainability
82
Quick install (universal)
Primary command for most environments:
npx skills add https://github.com/remotion-dev/skills --skill remotion-best-practicesManual fallback (if your runtime does not support direct installer command):
npx -y skills add https://github.com/remotion-dev/skills --skill remotion-best-practices -y -gRestart your current agent/runtime so the new skill is loaded.Run a dry run: "optimize this Remotion composition and subtitle pipeline".
- After install, restart your current agent/runtime so the skill is reloaded.
- Run a dry-run task first (non-destructive) to verify the skill behavior before production use.
SKILL.md (rendered source content)
Readable source reference for this skill. Added verification notes are shown in the sections below.
When to use
Use this skills whenever you are dealing with Remotion code to obtain the domain-specific knowledge.
Captions
When dealing with captions or subtitles, load the ./rules/subtitles.md file for more information.
Using FFmpeg
For some video operations, such as trimming videos or detecting silence, FFmpeg should be used. Load the ./rules/ffmpeg.md file for more information.
Audio visualization
When needing to visualize audio (spectrum bars, waveforms, bass-reactive effects), load the ./rules/audio-visualization.md file for more information.
How to use
Read individual rule files for detailed explanations and code examples:
- rules/3d.md - 3D content in Remotion using Three.js and React Three Fiber
- rules/animations.md - Fundamental animation skills for Remotion
- rules/assets.md - Importing images, videos, audio, and fonts into Remotion
- rules/audio.md - Using audio and sound in Remotion - importing, trimming, volume, speed, pitch
- rules/calculate-metadata.md - Dynamically set composition duration, dimensions, and props
- rules/can-decode.md - Check if a video can be decoded by the browser using Mediabunny
- rules/charts.md - Chart and data visualization patterns for Remotion (bar, pie, line, stock charts)
- rules/compositions.md - Defining compositions, stills, folders, default props and dynamic metadata
- rules/extract-frames.md - Extract frames from videos at specific timestamps using Mediabunny
- rules/fonts.md - Loading Google Fonts and local fonts in Remotion
- rules/get-audio-duration.md - Getting the duration of an audio file in seconds with Mediabunny
- rules/get-video-dimensions.md - Getting the width and height of a video file with Mediabunny
- rules/get-video-duration.md - Getting the duration of a video file in seconds with Mediabunny
- rules/gifs.md - Displaying GIFs synchronized with Remotion's timeline
- rules/images.md - Embedding images in Remotion using the Img component
- rules/light-leaks.md - Light leak overlay effects using @remotion/light-leaks
- rules/lottie.md - Embedding Lottie animations in Remotion
- rules/measuring-dom-nodes.md - Measuring DOM element dimensions in Remotion
- rules/measuring-text.md - Measuring text dimensions, fitting text to containers, and checking overflow
- rules/sequencing.md - Sequencing patterns for Remotion - delay, trim, limit duration of items
- rules/tailwind.md - Using TailwindCSS in Remotion
- rules/text-animations.md - Typography and text animation patterns for Remotion
- rules/timing.md - Interpolation curves in Remotion - linear, easing, spring animations
- rules/transitions.md - Scene transition patterns for Remotion
- rules/transparent-videos.md - Rendering out a video with transparency
- rules/trimming.md - Trimming patterns for Remotion - cut the beginning or end of animations
- rules/videos.md - Embedding videos in Remotion - trimming, volume, speed, looping, pitch
- rules/parameters.md - Make a video parametrizable by adding a Zod schema
- rules/maps.md - Add a map using Mapbox and animate it
- rules/voiceover.md - Adding AI-generated voiceover to Remotion compositions using ElevenLabs TTS
Required permissions
file, shell
Compatibility matrix
| Environment | Status | Notes |
|---|---|---|
| Remotion projects | pass | Guidance is tailored to Remotion composition and rendering workflows. |
| General React frontend apps | partial | Some patterns transfer, but most rules are video-domain specific. |
| No-FFmpeg environments | partial | Core Remotion guidance works, but media operations lose key capabilities. |
Verification log
Canonical install command executed
npx -y skills add https://github.com/remotion-dev/skills --skill remotion-best-practices -y -g
result: pass
Canonical source exists locally
test -f ~/.agents/skills/remotion-best-practices/SKILL.md
result: pass
Installed skill directory listed
ls -la ~/.agents/skills | rg "remotion-best-practices"
result: pass
Frontmatter + full body extracted
read ~/.agents/skills/remotion-best-practices/SKILL.md and split description/body
result: pass
Security notes
- Review FFmpeg commands before execution in shared environments.
- Avoid processing untrusted media inputs without validation/sandboxing.
- Log media pipeline changes for reproducible renders and rollback.
Common failures and fixes
Subtitle timing drifts from audio
Use the dedicated subtitles rules and normalize timing inputs before render.
Slow video processing steps
Move expensive transforms to FFmpeg pre-processing and cache intermediate outputs.
Non-deterministic render results
Pin dependency versions and stabilize composition timing logic.
Quick FAQ
How do I install this skill quickly?
Run npx skills add https://github.com/remotion-dev/skills --skill remotion-best-practices, then restart your runtime to reload skills.
What should I check before production rollout?
Confirm permissions, run a non-destructive dry run, and review rollback triggers.
What if install succeeds but actions do not run?
Verify SKILL.md location, restart runtime, and check environment/dependency readiness.
Recent changes
- 2026-02-15: Added hot-skill page entry from competitor ranking gap analysis.
- 2026-02-15: Installed canonical source and synced exact frontmatter description plus full SKILL.md body.
- 2026-02-15: Added verification layer (score, compatibility, fixes, rollback, and FAQ-ready structure).
Rollback triggers
- Video output quality regresses after composition refactor.
- Render times spike beyond acceptable CI/CD limits.
- FFmpeg pipeline changes introduce unstable or nondeterministic outputs.
Known issues
Skill file is concise and points to external rule docs
Load the referenced rules files for complete implementation details.
FFmpeg availability differs by environment
Verify ffmpeg binary and fallback strategy before rollout.
Related tutorials
Site references
- Source repository
- Original path: /remotion-dev/skills/remotion-best-practices
- License: check source repository
- Fetched/verified: 2026-02-15
- Third-party source summary with added verification and security notes.
- Alternative: frontend-react-best-practices
- Alternative: webapp-testing