---
id: gh-remotion-upgrade
name: "remotion-upgrade"
url: https://skills.yangsir.net/skill/gh-remotion-upgrade
author: remotion-dev
domain: ai-dev-tools-workflow
tags: ["remotion-upgrade", "dependency-management", "package-upgrade", "cli-tool", "version-management"]
install_count: 178700
rating: 4.80 (120 reviews)
github: https://github.com/remotion-dev/skills/tree/main/skills/remotion-upgrade
---

# remotion-upgrade

> 此技能用于一键升级 Remotion 项目及其相关依赖包，包括 Remotion、Mediabunny 兼容包和已安装的 Remotion Agent Skills。它会自动检测包管理器、检查本地 CLI、获取最新版本并执行升级，确保所有包版本一致且兼容。适用于需要快速安全升级 Remotion 项目的开发者。

**Stats**: 178,700 installs · 4.8/5 (120 reviews)

## Before / After 对比

### 升级耗时

**Before**:

开发者手动升级 Remotion 项目时，需要逐个检查多个包的版本、解决依赖冲突、更新 lockfile，过程繁琐且容易出错，平均耗时约30分钟。

**After**:

此技能自动完成所有升级步骤，包括版本检测、兼容性匹配和 lockfile 更新，平均耗时仅2分钟，且确保版本一致性。

| Metric | Before | After | Change |
|---|---|---|---|
| 升级时间 | 30分钟 | 2分钟 | -93% |

## Readme

# 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.


---
*Source: https://skills.yangsir.net/skill/gh-remotion-upgrade*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-remotion-upgrade/markdown*