Skip to content

The open-source full-stack studio for Opus 5.5 motion video. Reverse engineering for any video. Code video with HTML: recreate, edit and render. BYOA + BYOK · Motion.md · Images, Video, Music & Voice.

docs(motion): hand recreations over in the editor instead of as files

Awek-01518fb37c63577
diff --git a/AGENTS.md b/AGENTS.md
index e855f3e6..04fb7855 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -32,7 +32,7 @@ Use the [documentation index](docs/README.md) for related topics. Distinguish im
## Video production entry points
-Choose the entry for the current intent directly. Original creation, narrative/motion/sound redesign and creative review use motion-director; existing editable-template use/adaptation uses motion-template-to-video; reference-video reconstruction of this work uses motion-recreate (read user materials, rebuild the requested film in an editable project, measure against the reference and deliver a comparison; its rules and measurer ship inside the Skill); requested reusable template production uses motion-video-to-template. [motion-production](skills/motion-production/SKILL.md) handles scoped engineering under established creative decisions, preview, technical checks, troubleshooting and export. Its existing start resource retains short navigation; it is not a mandatory router.
+Choose the entry for the current intent directly. Original creation, narrative/motion/sound redesign and creative review use motion-director; existing editable-template use/adaptation uses motion-template-to-video; reference-video reconstruction of this work uses motion-recreate (read user materials, rebuild the requested film in an editable project, measure the export against the reference and hand over the project open in the editor; its rules and measurer ship inside the Skill); requested reusable template production uses motion-video-to-template. [motion-production](skills/motion-production/SKILL.md) handles scoped engineering under established creative decisions, preview, technical checks, troubleshooting and export. Its existing start resource retains short navigation; it is not a mandatory router.
A directly selected specialist reads shared context and continues; do not bounce back to the production start. Small edits, audio-only changes, review-only and export-only requests resume their affected scope. Keep existing decisions and locked content. Repository development and documentation do not trigger video production.
diff --git a/docs/usage.md b/docs/usage.md
index 04ab3639..0d215ac9 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -139,7 +139,7 @@ npm run dev
## Agent 工具
-仓库 Agent 从 [AGENTS.md](../AGENTS.md) 进入,Claude Code 同时读取 [CLAUDE.md](../CLAUDE.md)。按本轮意图直达专业入口:原创/大幅重编进入 [motion-director v1.4.5](../skills/motion-director/SKILL.md),已有模板出片或适配进入 [motion-template-to-video](../skills/motion-template-to-video/SKILL.md),参考视频复刻进入 [motion-recreate](../skills/motion-recreate/SKILL.md)(先读用户资料、最多问一次,用现有九个 Tool 在可编辑工程中重建,交付成片、原片对照和工程;规则与测量脚本随该 Skill 分发)。明确要求视频转可复用模板或 ZIP 时,单独进入 [motion-video-to-template](../skills/motion-video-to-template/SKILL.md)。[motion-production](../skills/motion-production/SKILL.md) 承接既定决定下的工程修改、预览、技术检查、排错与导出;重新设计局部动作或声音仍可直达 director。已有内容的修改统一复用 [edit 流程](../skills/motion-production/references/edit.md),核对保持项及后续延续;首次补读的结果须先返回模型,再执行依赖操作。
+仓库 Agent 从 [AGENTS.md](../AGENTS.md) 进入,Claude Code 同时读取 [CLAUDE.md](../CLAUDE.md)。按本轮意图直达专业入口:原创/大幅重编进入 [motion-director v1.4.5](../skills/motion-director/SKILL.md),已有模板出片或适配进入 [motion-template-to-video](../skills/motion-template-to-video/SKILL.md),参考视频复刻进入 [motion-recreate](../skills/motion-recreate/SKILL.md)(先读用户资料、最多问一次,用现有九个 Tool 在可编辑工程中重建,导出片对照原片测量后,交付在编辑器中打开的工程;规则与测量脚本随该 Skill 分发)。明确要求视频转可复用模板或 ZIP 时,单独进入 [motion-video-to-template](../skills/motion-video-to-template/SKILL.md)。[motion-production](../skills/motion-production/SKILL.md) 承接既定决定下的工程修改、预览、技术检查、排错与导出;重新设计局部动作或声音仍可直达 director。已有内容的修改统一复用 [edit 流程](../skills/motion-production/references/edit.md),核对保持项及后续延续;首次补读的结果须先返回模型,再执行依赖操作。
仅有 MCP 时通过 resources/list 与 resources/read 读取 `motion://workflow/production/start`;已选专业入口直接读对应路线,无需重新选路。固定引擎指南为 `motion://engine/SKILL.md`。详见 [Skill 路由](skills.md)。一期包含 motion-production、motion-director、motion-template-to-video、motion-recreate、motion-video-to-template 五个入口及参考。MCP workflow 短 ID 依次为 production/director/template/recreate/video-to-template;reference-video 仅留源码兼容入口。
diff --git a/skills/motion-recreate/SKILL.md b/skills/motion-recreate/SKILL.md
index bc41937f..3a90205e 100644
--- a/skills/motion-recreate/SKILL.md
+++ b/skills/motion-recreate/SKILL.md
@@ -2,8 +2,8 @@
name: motion-recreate
description: >-
Recreate a reference video (a link or file) as the user's own Motion film: rebuild it as an
- editable OpenMotion project and deliver the film with an original-versus-new comparison, keeping
- the original content or swapping in the user's copy, brand and assets. This includes small edits to
+ editable OpenMotion project and hand it over open in the editor, keeping the original content or
+ swapping in the user's copy, brand and assets. This includes small edits to
the user's own finished video when no editable project for it exists. "Make one like this" and "I
want this feel" both count as recreation. In a workspace with the user's product material, a bare
link alone means "make one like this for us". Not for only analysing or discussing a video. Use
@@ -16,7 +16,7 @@ description: >-
## Role and goal
-The user supplies a video and wants a version of it for themselves. Deliver three things: the exported film, the editable OpenMotion project and a side-by-side comparison with the reference. Check the film against the reference by numeric measurement and by inspecting extracted frames. This Skill carries the recreation rules and the measuring script; shared engineering rules still come from the documents in §0. [rebuild](references/rebuild.md) covers reading, measuring and rebuilding the reference; [check and deliver](references/verify.md) covers export, numeric measurement and the comparison. Use only the Tools actually returned by tools/list.
+The user supplies a video and wants a version of it for themselves. Deliver the editable OpenMotion project, open in the editor, where the user reviews it and keeps editing. Before handing it over, export it and check the exported film against the reference by numeric measurement and by inspecting extracted frames; the export is for this check, not a file to send. This Skill carries the recreation rules and the measuring script; shared engineering rules still come from the documents in §0. [rebuild](references/rebuild.md) covers reading, measuring and rebuilding the reference; [check and deliver](references/verify.md) covers export and numeric measurement. Use only the Tools actually returned by tools/list.
This workflow currently covers motion graphics only. For live action, talking heads or AI footage, say that this workflow does not support them yet. Do not suggest that footage or other material would make such a recreation possible: material the user provides can only go into a motion-graphics adaptation, which you may offer. State the limit as a fact about this workflow; never mention, quote or link this Skill or its files in the reply.
@@ -76,10 +76,10 @@ Then follow [check and deliver](references/verify.md): export the inspected vers
## 7. Deliver
-Copy the exported MP4 into the current workspace as `<name>-remix.mp4` and save the side-by-side `<name>-comparison.mp4` next to it, as [check and deliver](references/verify.md) describes. Leave the project open in the editor.
+The project open in the editor is the deliverable. Do not copy, link or attach the exported MP4 or other files unless the user asks for them.
-Reply briefly in the user's language with absolute local paths for the files (only the plain path in each link target, never a relative path): the remixed film and the comparison. For the editor, give the `previewUrl` returned by `motion_open_preview` and say the project is open there for further edits. Say in one or two sentences what changed, which assumptions you made from the workspace material, and any limitation the user would notice. When the reference, analysis or tools fall short, name the specific gap and its effect; never claim a faithful result that was not achieved.
+Reply briefly in the user's language. Give the `previewUrl` returned by `motion_open_preview` and say the project is open there for review and further edits. Say in one or two sentences what changed, which assumptions you made from the workspace material, and any limitation the user would notice. When the reference, analysis or tools fall short, name the specific gap and its effect; never claim a faithful result that was not achieved.
## 8. Follow-up requests
-Apply follow-ups to the same project with the shared edit workflow and export again; never start over. `motion_list_versions` and `motion_restore_version` bring back an earlier version as a new one. When the user is unhappy without saying why ("not satisfied", "第一版不太满意"), ask at most three multiple-choice questions in one batch, for example: follow the reference's story or tell our own; which feature is the hero; size and duration. Offer "you decide" as an option. Then revise the existing project.
+Apply follow-ups to the same project with the shared edit workflow and check them again as in §6; never start over. `motion_list_versions` and `motion_restore_version` bring back an earlier version as a new one. When the user is unhappy without saying why ("not satisfied", "第一版不太满意"), ask at most three multiple-choice questions in one batch, for example: follow the reference's story or tell our own; which feature is the hero; size and duration. Offer "you decide" as an option. Then revise the existing project.
diff --git a/skills/motion-recreate/references/verify.md b/skills/motion-recreate/references/verify.md
index bf59b5de..7b5977f8 100644
--- a/skills/motion-recreate/references/verify.md
+++ b/skills/motion-recreate/references/verify.md
@@ -32,13 +32,3 @@ Fix failures by resizing, wrapping, moving, re-timing or adding the missing laye
## 4. Record
Keep the record outside the live project, in the workspace `VERIFY.md` described by the shared verification: the source video and checksum, the material used, requested changes, assumptions, remaining differences, the measurement table (moments, elements, regions, values, results) and every check as passed, failed or not run. Real review evidence can also be stored with `action: "record_review"` on `motion_export_request`. Humans decide visual acceptance.
-
-## 5. Comparison video
-
-Save a side-by-side `<name>-comparison.mp4` next to `<name>-remix.mp4` in the workspace: original left, remix right, on one clock, H.264 at web bitrate. For example, with both scaled to the same height (use the package's FFmpeg when `ffmpeg` is not on `PATH`):
-
-```sh
-ffmpeg -i reference.mp4 -i remix.mp4 -filter_complex "[0:v]scale=-2:540[a];[1:v]scale=-2:540[b];[a][b]hstack=inputs=2[v]" -map "[v]" -map 1:a? -c:v libx264 -crf 28 -pix_fmt yuv420p -c:a aac <name>-comparison.mp4
-```
-
-The comparison is for human review only; it is not part of the project.