# Cyxj Remotion Overlay

> Remotion 出片的私有规则叠加层。用户用 Remotion、React 视频、口播叠加图形、Sequence、spring、interpolate 做视频时使用。必须叠加官方 Remotion skill,不替代官方 skill。

- **Type:** Skill
- **Install:** `agentstack add skill-vibe-motion-remotion-starter-cyxj-remotion-overlay`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [vibe-motion](https://agentstack.voostack.com/s/vibe-motion)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [vibe-motion](https://github.com/vibe-motion)
- **Source:** https://github.com/vibe-motion/remotion-starter/tree/main/.claude/skills/cyxj-remotion-overlay

## Install

```sh
agentstack add skill-vibe-motion-remotion-starter-cyxj-remotion-overlay
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# cyxj-remotion-overlay

这是本工作台的 Remotion 私有规则层。先按官方 Remotion skill 和工程红线做正确实现,再套你自己的视觉与口播设计系统。

## 必读顺序

1. 官方 Remotion skill(`remotion-best-practices`)。
2. `docs/HARD_RULES.md`(工程红线:frame 驱动 / interpolate 带 clamp / 确定性渲染 / 资源进 public/…唯一真源)
3. 你自己的设计系统(色彩语义 / 构图 / 人脸禁区 / 标注)——本仓给的是 `kit/theme.ts` 占位色板,把它换成你自己的。

> 作者的完整设计说明书(两套主题 / 构图规范 / 动效手感 / 音画节奏 / 验收清单)是私有沉淀,**本仓不含**;按同样机制沉淀你自己的那几份。

## 起手姿态:为这一刻造画面,不是先翻库

做任何一段画面前,**默认动作是「用官方原生 Remotion 把这一刻需要的画面搭出来」**,不是「先看库里有什么能用」。镜头库是**保底 + 品牌积木供应**,不是起手就得翻的目录。

> 但这不是要你把标准重复内容也手搓一遍——口播底、标准内容卡、数据卡这种库里干得好的,该复用就快复用。「原生先行」针对的是:**有创意选择 / 用户点名要新东西 / 库里没有正好对的**——那些时刻。

复用是**判断之后的主动选择**,不是开工反射:
- ✅ 合理复用 —— 这一刻**确实是标准重复内容**(口播底、标准内容卡…),且库里那个镜头**正好就是干这个动作的、质量达标**。说得出「为什么是它」。
- ❌ 削足适履 —— 为了「库里有个差不多的」,把原本想要的画面**改成那个镜头的样子**。这不是复用,是拿复用偷懒、把创意做没了。

> **铁律**:用户说要「新镜头 / 新效果 / 换个做法」时,默认就是**真的造**。不许先翻库、拿「库里有个类似的」把用户劝回去。要复用,先说清它**确实是重复内容 + 库里那个正好对**——说不清就是该造。

## 怎么决定一段画面怎么做

先短路,再决定——别一上来就走全程:

- ▸ **明显是标准重复内容、库里有个镜头正好对、且这一刻用户没要求换新的** → 直接复用,跳过下面 5 步。
- ▸ **其余**(用户要了新东西 / 库里没有正好对的 / 你正想把它「掰成」某个现成镜头)→ 走下面完整 5 步,原生先行。

5 步(对要决定的那个语义单元 / beat):

1. **意图** —— 这句要让观众 get 到什么(信息 / 情绪 / 反转 / 强调)。按时间码 + 逐字稿做语义联想。
2. **画面动作** —— 这个意图配什么**视觉动词**(逼近 / 暴涨 / 收拢 / 划掉 / 砸下 / 平移…)。**先定动作,别先想「用哪个镜头」。**
3. **标杆 & 参考** —— 已完成成片里类似意图怎么做的、质量线在哪,对齐别低于它。**遇到「新卡片 / 要高级感 / 全新视觉方向」别凭口味直接做**:先联网看官方 / 专业设计怎么处理(色彩×背景融合、效果、版式)再动手。凭感觉连调 = 反复被推翻。
4. **怎么搭** —— **默认:官方原生(interpolate / spring / Sequence)+ `kit/theme.ts` token,把第 2 步那个动作直接搭出来。** 库里正好有一个就是干这个动作、且达标 → 才用它。官方能不能做、用哪个 API,照走官方 skill / `remotion-documentation` MCP,别凭记忆。
5. **补 & 沉淀** —— 不满意 / 缺品牌件 → 拉库里的**积木**补(玻璃卡 `GlassCards` / 字幕 `SrtCaptions` / 口播轨 `SpeakerTrack` / 运镜姿态 `poses`)。做出来确实好用、且会跨片重复 → 走**组件晋升**(见 `kit/CLAUDE.md` 组件晋升节)沉淀回 kit。

> 框架红线照守(frame 驱动、interpolate 带 clamp、确定性渲染、资源进 public/…见 `docs/HARD_RULES.md`)——**原生手写更容易踩,反而要盯紧**。

## 资产和模板

```text
kit/           # 共享层:引擎级组件 + 5 个基础镜头 + 占位色板
template/      # 起手模板(复制它开新片)
```

## 关键纪律

- 不在仓库根目录跑 CLI(没 package.json);命令一律先 `cd template/` 或你复制出的工程。
- 不手改官方 Remotion skill。
- 复用镜头库的「积木」(玻璃卡 / 字幕 / 运镜姿态…)是对的,别误读成「连积木都重写」;该造新就原生造、该复用积木就复用,按上面「怎么决定一段画面怎么做」走。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [vibe-motion](https://github.com/vibe-motion)
- **Source:** [vibe-motion/remotion-starter](https://github.com/vibe-motion/remotion-starter)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-vibe-motion-remotion-starter-cyxj-remotion-overlay
- Seller: https://agentstack.voostack.com/s/vibe-motion
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.