# Remotion Upgrade

> Upgrades Remotion packages, compatible Mediabunny dependencies, and installed Remotion Agent Skills to their latest aligned versions.

- Skill: `remotion-dev/remotion-upgrade` (Agent Skill)
- Install (CLI): `npx skillmds add remotion-dev/remotion-upgrade`
- Raw SKILL.md: https://api.skillmd.com/api/skills/remotion-dev/remotion-upgrade/raw
- Safety review: CAUTION (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools, DevOps & Infra, Deployment & Release, Dev Tooling
- Tags: Cli, Mediabunny, Npm, Package Upgrade, Remotion, Video Rendering
- Author: Remotion (https://skillmd.com/u/remotion-dev)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/remotion-dev/remotion-upgrade

---


# Upgrade Remotion

1. Inspect the project manifests and lockfile to identify the package manager and workspaces. Preserve unrelated changes.
2. Determine whether `@remotion/cli` is locally available. If it is, run:

   ```bash
   npx remotion upgrade
   ```

   Skip the manual package upgrade below.

3. If `@remotion/cli` is not available, upgrade manually:
   - Get the latest stable Remotion version with `npm view remotion version`.
   - Find every installed `remotion` and `@remotion/*` dependency across the project and upgrade them all to that exact version. Preserve their dependency sections and the project's workspace or catalog conventions.
   - Read the current [Mediabunny compatibility page](https://www.remotion.dev/docs/mediabunny/version) and determine the Mediabunny version compatible with the target Remotion version. Upgrade every installed `mediabunny` and `@mediabunny/*` package to the documented compatible version.
   - Run the project's package manager to update its lockfile.
4. Update the installed Remotion skills:

   ```bash
   npx remotion skills update
   ```

5. Review the manifest and lockfile diff. Ensure all Remotion packages use one version and all installed Mediabunny packages use the compatible version. If the CLI is available, run `npx remotion versions` as an additional check.

The [Remotion releases](https://github.com/remotion-dev/remotion/releases) contain the changelog and may be useful for summarizing relevant changes after the upgrade.