Communitygithub.com

costa-marcello/skillkit

指导使用 React 进行 Remotion 视频开发,涵盖合成、动画、时序、音频、字幕和渲染。当用户处理 Remotion 项目、编写 <Composition>/<Sequence>/interpolate/spring、编辑 remotion.config.ts、渲染或部署 Lambda 视频,以及询问使用 React 创建视频时,加载此技能。

skillkit 是什么?

该技能 (skill) 为 AI 代理 (如 Claude Code, Cursor, Codex) 提供全面的 Remotion 开发知识库,旨在减少常见错误并加速视频制作工作流。它覆盖了从项目脚手架创建 `npx create-video`、开发预览 `npx remotion studio` 到最终 Lambda 部署的完整生命周期。核心内容以规则文件 (rules) 的形式组织,分为核心 (Core)、媒体 (Media)、音频 (Audio)、文本 (Text)、高级 (Advanced)、实用工具 (Utilities)、生产 (Production)、集成 (Integration) 和包 (Packages) 等类别,提供了详细的代码示例和最佳实践。技能特别强调了非确定性随机数、未 memoised 的 Player inputProps、错误的 `delayRender` 使用等常见陷阱,帮助开发者写出更健壮、性能更佳的 Remotion 视频。它还包含对 `@remotion/player`、`@remotion/lambda` 和 `@remotion/renderer` 等关键库的专门指导,适用于从简单动画到复杂、可参数化的客户端应用程序的各种场景。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/costa-marcello/skillkit/tree/HEAD/skills/remotion-video

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

何时使用

在您编写或阅读 Remotion 代码时,从项目脚手架搭建到最终视频渲染的整个过程中,加载此技能。

常见 AI 错误(需避免)

在提交之前,请对照这些反复出现的失败模式检查每一项 Remotion 代码更改:

  • 非确定性随机数 —— 使用 remotion 的 random(seed),绝对不要使用 Math.random()、Date.now() 或 new Date()。否则并行渲染会导致闪烁噪声。
  • 未 memoised 的 <Player> inputProps —— 始终传递 memoised 的 props;未 memoised 的 props 会导致整个组件树发生重新渲染风暴。
  • 异步操作(fetch、字体加载、测量)缺少 delayRender() / continueRender()。缺少它们会导致渲染在 30,000 毫秒时挂起。
  • 字幕的 inputRange 非单调递增 —— interpolate 的 inputRange 必须严格递增。对于短片剪辑,使用 Math.min(10, Math.floor(duration / 3)) 作为淡入淡出窗口。
  • 处处使用线性缓动 —— 优先使用 spring() 实现自然运动;仅在明确的技术需要时使用线性缓动。
  • 忘记 @remotion/google-fonts 的导入 —— 每个字体都需要显式调用 loadFont({ weights, subsets })。
  • 单个巨型合成输出 —— 将场景拆分为多个小型、聚焦的合成,并使用 <Sequence> 或 <TransitionSeries> 进行组合。
  • 已弃用的 startFrom / endAt —— 改用 trimBefore / trimAfter 代替。

新项目搭建

当您处于一个没有现有 Remotion 项目的空文件夹或工作区时,使用以下命令创建一个项目:

npx create-video@latest --yes --blank --no-tailwind my-video

将 my-video 替换为合适的项目名称。

启动预览

启动 Remotion Studio 来预览视频:

npx remotion studio

可选:单帧渲染检查

您可以使用 CLI 渲染单帧以快速检查布局、颜色或时序。对于微不足道的编辑、纯重构图,或者当您已经从 Studio 或之前的渲染中获得足够信心时,可以跳过此步骤。

npx remotion still [composition-id] --scale=0.25 --frame=30

在 30 fps 下,--frame=30 表示一秒标记(--frame 从零开始计数)。

规则索引

阅读各个规则文件以获取详细说明和代码示例。

核心

媒体

音频

文本

高级

实用工具

生产

集成

包

  • packages/paths.md - @remotion/paths SVG 路径工具(interpolatePath、warpPath、getLength)
  • packages/shapes.md - @remotion/shapes 预构建 SVG 原语(Triangle、Circle、Star、Pie、Heart)
  • packages/noise.md - @remotion/noise 种子化 Perlin 噪声(noise2D、noise3D、noise4D)
  • packages/motion-blur.md - @remotion/motion-blur Trail 和 CameraMotionBlur(谨慎使用)
  • packages/skia.md - @remotion/skia 高性能 Canvas(React Native Skia)
  • packages/rive.md - @remotion/rive 状态机动画(Lottie 替代方案)

相关技能