nexu-io/openmotion / skills/openmotion-director
openmotion-director
VerifiedPlan and create original motion videos and motion graphics with OpenMotion, including esports recaps, explainers, product demos, and brand films, or first planning how a video should be presented. Also use for narrative, motion, or sound redesign and creative review. Execute established edits/exports with openmotion-production, editable templates with openmotion-template-to-video, reference reconstruction with openmotion-recreate, and reusable templates with openmotion-video-to-template. Repository development does not trigger video production.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.4 KB |
| agents/openai.yaml | config | 353 B |
| references/action-script.md | markdown | 13.5 KB |
| references/examples.md | markdown | 8.5 KB |
| references/motion-craft.md | markdown | 11.9 KB |
| references/motion-phrases.md | markdown | 8.5 KB |
| references/sound-narrative.md | markdown | 4.9 KB |
references/action-script.md
View on GitHub# 动作脚本:决策记录与按需展开
## 阅读导航
- 普通创作:读“最小记录”和“时间约定”。
- 动作复杂或需要交接:选读对应的“展开模块”。
- 需要可直接改写的格式:用“可复制工作表”,删除无关部分。
- 需要理解粒度:看末尾两个填写例;更多表达方式见 [正反例](examples.md)。
## 模板的边界
脚本应减少执行歧义,不替代导演判断。必需的是能回答相关决策问题,不是填写固定字段。一个简单镜头可以写成几句话;复杂段落可用时间表、对象状态表或 YAML。不要输出全部空表,不要求每帧记录。
先决定内容与表达方法,再挑字段。不要因为有“触发”“承接对象”字段,就凭空增加点击、光标、物体飞行或无缝转场。多镜头、单镜头、固定机位和非线性叙事都兼容。
## 最小记录:每个有独立职责的段落回答这些问题
| 决策 | 要明确什么 | 可接受的简写 |
| --- | --- | --- |
| 意图与依据 | 观众应理解、感受或注意什么;涉及事实时依据是什么 | “感到安静与精密;不声称性能提升” |
| 可见/可听的表达 | 什么真的发生了;变化如何使理解、期待或感受发生发展,而不只是元素入场 | “一道光掠过壳体,显露接缝,机位不动” |
| 时间组织 | 大致时长或事件锚点,哪些先后、重叠、停顿;什么必须被读清 | “接缝显露后才出现型号,停留到读清” |
| 上下文关系 | 如何承接或切断前后段落;单段可省略 | “形状呼应后直接硬切,不模拟同一空间” |
| 验证 | 看哪段、观察什么才知道设计成立 | “正常速度能看出材质变化,文字不被扫光遮挡” |
关键表达可用“起先观众看到/预期什么 → 实际发生什么 → 因而理解/感到什么”检查逻辑;这不是必须采用的三段时间结构。若是产品功能,注明动作展示的是实际行为还是概念说明。不要把这个问题变成固定的混乱—整理、点击—结果或前后对比套路。
对象身份、精确坐标与缓动仅在存在相关歧义时补充。全片共享的规则只记录一次,镜头只写例外。
强 Motion 的关键事件写到足以区分两种不同观看结果:起初能看见什么、主体改变了哪种关系、变化在哪一刻最清楚、最后如何落定或退出。“翻开”“依次展开”“镜头后退”仍有歧义时,补充转轴与退出方向、真实遮挡与独立裁切的分工,或主体动作与镜头变化的先后。只展开影响实现与观感的决定,不把所有动作强制写成同一种相位或参数表。
## 全片层记录
When visual language is selected or changed, record the subject-specific materials and consequential text roles, faces/weights and mixed-language treatment in the existing creative record. Reuse confirmed brand/template decisions; scenes record exceptions only.
用短文或表格记录以下与本次任务相关的内容:
- 简报:受众、信息优先级、时长/比例、品牌、声音、事实与素材约束。
- 创意主线:为何使用这种动态表达,它与素材有什么关系。
- 时间结构:段落目的、预计区间或事件、信息密度与能量变化。可以恒定、突变、循环或递进,不强制高潮曲线。
- 运动语言:动作的性格与选择理由,主要注意力如何分配,哪些保持稳定。参数范围可在原型后确定。
- 素材与风险:真实界面、概念示意、占位内容、待验证技术能力。
全片概览中的段落不必等长;“开场—痛点—功能—结果—CTA”只是可能结构,不是默认表头。
## 时间约定
1. 同一记录中明确使用全片时间还是段落局部时间。混用时写出 offset。用事件锚点也可以,例如 `旁白说到“找到”时`。
2. 计划阶段用区间、相对关系或锚点;实现阶段再绑定实际素材、时间线与帧率。不要提前用虚假精确的毫秒掩盖未做的决定。
3. 区分动作时间、可读时间和有意静止;文字完成入场不代表读完。按语言、字数、字号、屏幕尺寸与观看环境验证,不套固定阅读公式。
4. 用 `with / after / before / overlap / at` 或自然语言说明关键关系。顺序与重叠都可以成立;若观众必须看清因果,不能为“更丝滑”过度重叠。
5. 多个动作同时发生时,说明注意力如何分配。并行比较也可能需要两个等重要对象,不能机械强制只有一个主体。
6. 使用音乐节拍时,按原始节拍索引映射到帧,避免逐次累加舍入误差。不是所有动作都要踩拍,内容与理解可以优先。
## 展开模块:只选需要的部分
### A. 对象、状态与空间
用于聚合、拆解、形变、产品操作、图解或跨镜头追踪。
| 对象 ID | 信息职责/来源 | 关键状态 | 空间或层级 | 必须保持什么 |
| --- | --- | --- | --- | --- |
| 自定义 | 主体、对照、背景等 | 按需要列初始/中间/结束 | 局部或画面坐标、遮挡关系 | 身份、内容、比例等 |
布局未定时,用归一化坐标或相对关系;布局定后再补精确数值。需要形变时写明对应点、容器/内容的分工、遮罩与不可变形部分。明确哪些允许夸张、哪些必须保持准确;品牌标识形变遵循本次创作授权,不能把真实产品文字和数据改成错误含义。
### B. 动作事件
用于多动作协作、重复节奏或精确产品演示。事件行数由动作决定。
| 区间/触发 | 对象与变化 | 路径或变化方式 | 与其他动作关系 | 视线/声音 | 观察点 |
| --- | --- | --- | --- | --- | --- |
| 自定义 | 从什么到什么 | 有必要才指定 | 先后、重叠、同步等 | 吸引、保持或转移注意 | 可见的成功条件 |
按需要补充启动、加速、接触、回弹、稳定等阶段;不是每个动作都要有完整物理表演。声音配合因果或情绪,不要求每动一次就加音效。
### C. 镜头与构图
用于推拉、摇移、景别变化、视差、3D 或重新构图。
- 摄影机与对象分别在动什么,运动要揭示什么。
- 开始与结束景别、焦点、视线落点;需要时补路径与透视。
- 哪些内容保持稳定供阅读,哪些有意出画或被遮挡。
- 固定机位无需虚构运镜;强调前后对比时,保持构图可能更有效。
### D. 镜头交接
复用“上下文关系”记录,重要接点只补尚未明确的一两句:上一段最后的注意重点是什么,下一段首先要建立什么,二者是延续、对照还是明确切断,以及观众如何跟上。重要接点包括观看重点显著改变、对象身份易混淆或已出现问题的位置;重复关系全片写一次,例外再展开,不另造必填表。真实与概念素材的身份保持清楚,不能以无缝效果制造虚假连续操作。
对影响理解或节奏的切点,在同一条记录里写清前镜最后的有效状态、后镜第一个可跟随的状态,以及哪一层声音跨过切点或为何在这里停。例子是比分留在原位,背景先换,再更新左侧数字,配乐沿原乐句继续。无声作品只需写画面交接。
先写内容关系,再选择机制。以下是选项,不是穷尽的类别:
| 所选机制 | 需要记录 | 不需要强加 |
| --- | --- | --- |
| 同对象延续/容器展开 | 对象身份、接点边界、内容与遮罩、层级、是否同一实例 | 整片无缝、一律运动中切镜 |
| 动作匹配 | 切点、可见方向、速度/相位关系、注意力落点 | 所有镜头同轴同向 |
| 构图或形状匹配 | 哪些视觉关系呼应,哪些内容发生替换 | 虚构物理连续性 |
| 硬切/跳切 | 转折理由、切点、前后重点、理解是否中断 | 承接物、位移或补间动画 |
| 淡化/叠化 | 表达的时间或情绪关系、重叠区、文字和主体的可辨认性 | 机械禁止淡化 |
| 声音连接 | 音频来源、跨界区间、画面切点、信息冲突检查 | 必须同时有视觉转场 |
| 单镜头持续发展 | 内部状态如何推进、哪里需要重新聚焦 | 为模板拆出镜头边界 |
如果选择同对象连续,记录接点前后的几何与外观;如果选择运动匹配,再记录速度。不把连续性的数值要求应用到有意的跳切。
若选择“覆盖前场”的遮罩、擦除或物体扩张,检查未覆盖区域实际显示的内容:旧场是否过早结束,新场底层是否先挡住旧场。旧内容何时退出由所选交接意图决定,不由组件默认结束决定。硬切、淡出淡入及有意空拍不适用这一约束;硬切也可直接落在清楚的下一构图。
### E. 文字、数据与声音
- 文字:精确文案、语义重音、拆分单位、最终阅读状态;允许文字本身成为主要动作。
- 数据:数值与来源、比较基准、轴/单位、形变是否产生误导;动态揭示不能改变比例含义。
- 声音:使用真实可用音轨、临时节奏或无声;分别判断旁白与字幕是否必需,避免在已同步演出的大字排版上叠放重复字幕。启用字幕时,按 [配音与可编辑字幕协同](../../openmotion-production/references/sound.md#配音与可编辑字幕协同) 绑定真实时间与预设样式;最终更换音轨后重验相关时序。
- 用户未要求时,不为了填表强加旁白、字幕、音乐或音效。
声音需要参与叙事或重新设计时,先按 [声音叙事](sound-narrative.md) 确定段落关系、动作反馈、主次与留白,再填写下面的时间锚点。不能用对齐表替代声音方案。
#### 声画锚点:有声音职责时使用
应用 [共享声音执行与实际时间锚点](../../openmotion-production/references/sound.md#声画锚点有声音职责时使用),在本脚本记录选定关系,不另抄一套锚点规范。
### F. 实现交接
记录引擎、项目版本、画幅/帧率、素材位置、可定位的对象名、局部与全局时间换算。只描述实际使用的 API。
多处动作与音频需要共同改时长时,复用宿主事件标签或共享时间数据,减少重复写时间常数;简单事件无需额外文件。
复杂接点可使用局部对象映射或共享容器,不先规定代码架构。技术不支持原方案时,比较影响最小的替代表达;重要差异必须说明。
## 可复制工作表
以下是编辑起点,不是严格 schema。删除不相关项,允许用短文替代。
```yaml
segment: 自定义名称
intent: 观众理解或感受什么
evidence: 涉及事实时填写依据;概念化表达需注明
time: 全片区间/局部时长/事件锚点,并明确时间基准
expression: 实际变化及其带来的理解/感受;不是只写入场方式
timing: 关键顺序、重叠、停顿与阅读安排
context: 与前后内容的关系;无相邻段落时省略
observe: 实际播放时要检查的现象
# 仅在有关联时加入下面模块,不保留空字段
objects: 对象身份、关键状态、空间与不可变项
events: 关键动作事件,不逐帧列举
camera: 机位/景别变化及其目的
handoff: 所选连接机制需要的状态与时间
text_audio: 精确文案、声音事件与时间、对应视觉事件及相位;有意错拍的理由
implementation: 素材与工具约束、待确定参数
```
## 填写例一:产品行为,使用动作与交接模块
意图:让观众理解分类关系;这是概念动画,真实功能在后续产品界面证明。
时间:局部 0–6 秒,只是待验证初稿。
对象:`files` 保持身份;`groups` 是分类容器;`selected_group` 后续持续存在。
| 局部时间 | 可见变化 | 关系与观察点 |
| --- | --- | --- |
| 0–0.7s | 分类依据显现,散乱文件开始归组 | 先建立依据,不能像随机吸附 |
| 0.5–2.6s | 多组文件分批移动到对应容器 | 路径和启动时间允许区分,不必全部同时或全部顺序 |
| 2.3–3.2s | 完成的组收拢,最后一组继续归位 | 主次随完成状态变化,不额外加一次统一弹跳 |
| 3.2–4.6s | 结果稳定,短文案解释分类依据 | 实际播放确认读清;时长可调整 |
| 4.6–6s | 选中目录展开,承接下一段真实界面 | 边界连续,不出现旧新容器重影 |
交接:延续 `selected_group` 的视觉身份。到接点记录它的实际边界、颜色、圆角与遮罩;内层界面显现不能覆盖尚需阅读的文字。这里无需规定全片运动方向。
审核:分类能否被理解?结果有没有可读时间?接点有没有跳变?这些动作只适合此任务,不作为通用事件表。
## 填写例二:静观式品牌片,不使用对象交接模块
意图:表现耳机外壳的精密与安静,不介绍未经证实的音质指标。
表达:固定近景,一道掠射光缓慢经过真实外壳素材,显露接缝;机位和型号保持稳定。若只有平面照片,先验证能否可信地实现光照变化,不伪造 3D 结构。
时间:根据接缝被清楚看见的时刻确定型号出现;其后保持足够阅读时间。声音可无,按简报决定。
连接:材质细节结束后直接硬切整体轮廓,以尺度变化形成释放;不添加飞行对象或容器展开。
观察:静止是否让材质细节成为注意中心?光照变化是否自然?硬切之后能否辨认同一产品?
这是完整的动作脚本,不因没有时间表、因果点击或匹配速度而不合格。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |