@autoaiai/aicut 0.1.11 → 0.1.13

package/skills/qisi-video-remix/examples/creative-plan.md

@@ -1,133 +0,0 @@
-# 《先别急着误会》创意改编策划
-
-全片 30 秒 · 用户选择单段上限 15 秒 · 9:16 竖屏 · 写实生活短片 · 无对白字幕或解释性叠字。
-
-**材料范围：** 本示例使用虚构文字梗概演示交付格式，没有输入真实视频。参考梗概为：“办公室里，一个人拿走同事桌上的杯子，同事以为他偷喝，后来发现他在接漏水，保护桌下的电脑。”因此没有原片时间码、真实转写或视频参数。本示例假设用户已明确选择单段上限 15 秒；本片镜头兼容性与时长允许规划两个 15 秒段落。生成模型未指定，尚未验证工具支持。
-
-## 参考与改编思路
-
-参考故事借助“先看见可疑动作，后看见善意目的”制造误会。证据来自文字梗概中拿杯子和接漏水的两个事件。
-
-新故事移到雨天便利店：顾客误以为青年要拿走店里的伞，随后看见他在替送货人挡雨。顾客从准备阻止，变成主动扶门。保留信息逐步揭示的方法，重新设计了行动、帮助对象和顾客的选择。
-
-## 完整剧本
-
-**便利店门口，白天下雨。**
-
-门内右侧放着一把收起的蓝伞。穿米色风衣的小雨刚走到门口，就看见灰卫衣青年阿林拿起伞。他看向门外，说：“借一下。”
-
-小雨皱眉，伸手想叫住他。阿林已经跨出门，把伞撑开。伞面一时挡住了小雨的视线。
-
-小雨从门内侧身望出去：一位穿深蓝工作服的送货大叔正抱着纸箱站在雨里，双手腾不开。阿林把伞举到大叔头顶，自己的半边肩膀留在雨中。
-
-小雨收回拦人的手，转而撑住向外开的玻璃门：“我来扶。”
-
-大叔抱箱子走进店里，朝她点头。阿林在门外收伞，小雨和他相视一笑。雨还在下，门口没有人再被淋着。
-
-## 人物与场景
-
-| 人物 | 稳定外貌 | 本片造型 |
-| --- | --- | --- |
-| 小雨 | 年轻女性，黑色齐肩直发，圆脸 | 米色风衣、白色内搭、黑色长裤 |
-| 阿林 | 年轻男性，黑色短发，偏瘦 | 灰色连帽卫衣、深色牛仔裤 |
-| 送货大叔 | 中年男性，短发，方脸 | 深蓝工作服、黑色工作鞋，双手抱一个棕色纸箱 |
-
-**场景：便利店入口。** 玻璃门向室外打开；门内右侧有伞架，最初放着一把收起的蓝伞。门外是无顶棚人行道，地面湿润。门内暖光，室外阴雨天自然光。玻璃门的摆动范围与送货人的站位留出距离。
-
-**道具状态：** 蓝伞由伞架取出，撑开为大叔挡雨，最后收起；纸箱始终由大叔双手抱持。参考图尚未制作，各段提示词直接描述外观，不假设已有图片输入。
-
-## 角色与场景生图提示词
-
-以下是待生成参考图的文字提示词，尚未生成或绑定图片。身份图用于确定面容，造型图用于确定全身穿着；正式制作时可在身份图确认后，将其作为对应造型的真实参考输入。
-
-### 小雨 · 身份参考图
-
-```text
-写实生活电影摄影风格，年轻女性，圆脸，黑色齐肩直发，自然肤色与真实皮肤质感，神情自然。正面胸像，完整呈现头顶、头发与肩部，面容清晰，柔和均匀光线，中性浅灰背景，素色基础上衣，不带场景道具。单人单张，不拼贴，不添加文字、标签或水印。
-```
-
-### 小雨 · 米色风衣造型参考图
-
-```text
-写实生活电影摄影风格，年轻女性，圆脸，黑色齐肩直发，自然肤色与真实皮肤质感，穿米色风衣、白色内搭、黑色长裤和简洁黑色平底鞋。正面全身站姿，双手自然垂放，头部到鞋履完整入画，服装层次与轮廓清楚，柔和均匀光线，中性浅灰背景。单人单张，不拼贴，不添加文字、标签或水印。
-```
-
-### 阿林 · 身份参考图
-
-```text
-写实生活电影摄影风格，年轻男性，黑色短发，偏瘦体态，自然肤色与真实皮肤质感，神情平和。正面胸像，完整呈现头顶和肩部，五官清晰，柔和均匀光线，中性浅灰背景，素色基础上衣，不拿雨伞或其他道具。单人单张，不拼贴，不添加文字、标签或水印。
-```
-
-### 阿林 · 灰卫衣造型参考图
-
-```text
-写实生活电影摄影风格，年轻男性，黑色短发，偏瘦体态，自然肤色与真实皮肤质感，穿灰色连帽卫衣、深色牛仔裤和简洁深色休闲鞋，帽子放下。正面全身站姿，双手自然垂放，头部到鞋履完整入画，清楚呈现服装轮廓。衣服为干燥初始状态，不拿雨伞。柔和均匀光线，中性浅灰背景。单人单张，不拼贴，不添加文字、标签或水印。
-```
-
-### 送货大叔 · 身份参考图
-
-```text
-写实生活电影摄影风格，中年男性，短发，方脸，自然肤色与真实皮肤质感，神情朴实自然。正面胸像，完整呈现头顶与肩部，五官清楚，柔和均匀光线，中性浅灰背景，素色基础上衣，不抱纸箱。单人单张，不拼贴，不添加文字、标签或水印。
-```
-
-### 送货大叔 · 深蓝工作服造型参考图
-
-```text
-写实生活电影摄影风格，中年男性，短发，方脸，自然肤色与真实皮肤质感，穿深蓝色工作服上衣、同色工作裤和黑色工作鞋，无品牌标识。正面全身站姿，双手自然垂放，头部到鞋履完整入画，清楚呈现服装版型与颜色，不用纸箱遮挡衣服。柔和均匀光线，中性浅灰背景。单人单张，不拼贴，不添加文字、标签或水印。
-```
-
-### 便利店入口 · 场景参考图
-
-```text
-9:16 竖屏，写实生活电影摄影风格，白天下雨的便利店入口空镜。从门内斜向门外拍摄，画面清晰展示玻璃门、门槛与室外无顶棚人行道。玻璃门向室外开启，开启空间宽敞；从店内朝外看，门内右侧有伞架，放着一把收起的蓝伞。室内暖光与室外阴雨天柔和自然光形成轻微冷暖对比，人行道湿润有细小雨水反光，门口留出抱箱通行的空间。无人，不放正在移动的纸箱，不添加字幕、标题、说明标签或水印。单张场景图，不拼贴。
-```
-
-## 分镜表
-
-| 镜头 | 全片时间／时长 | 人物与场景 | 画面和运镜 | 对白与声音 |
-| --- | --- | --- | --- | --- |
-| S01 | 00:00–00:05／5 秒 | 阿林灰卫衣、小雨米色风衣；门内 | 中景固定机位。阿林从右侧伞架取蓝伞，小雨看向他的手。门外送货人暂被门框遮挡。 | 雨声；阿林：“借一下。” |
-| S02 | 00:05–00:10／5 秒 | 小雨、阿林；门口 | 小雨近景，皱眉并伸出手；焦点转到跨出门的阿林，他开始撑伞。 | 脚步声、雨声，无新增对白。 |
-| S03 | 00:10–00:15／5 秒 | 阿林、送货大叔；门外 | 从门内小雨视角轻微侧移。蓝伞撑开并抬起，露出抱箱站在雨中的大叔。 | 伞骨展开声、雨声。 |
-| S04 | 00:15–00:20／5 秒 | 阿林、大叔；门外 | 中近景。阿林把伞移到大叔和纸箱上方，自己的肩膀留在雨中；大叔看向他，点头。 | 雨滴落在伞面，无对白。 |
-| S05 | 00:20–00:25／5 秒 | 小雨、大叔、阿林；门口 | 中景。小雨收回拦人的手，迈到门边撑住玻璃门；大叔抱箱向入口迈步，阿林持伞跟随半步。 | 小雨：“我来扶。”脚步声。 |
-| S06 | 00:25–00:30／5 秒 | 三人；门内外 | 固定中景。大叔跨过门槛，朝小雨点头；阿林在门外收伞，小雨扶门与他相视一笑。 | 雨声、轻微收伞声，无新增对白。 |
-
-## 生成分段
-
-| 生成段 | 覆盖镜头 | 实际时长 | 切分原因 | 起始 → 结束状态 |
-| --- | --- | --- | --- | --- |
-| T01 | S01–S03 | 15 秒 | 同一入口空间内的连续动作；在揭示大叔后达到上限 | 蓝伞在伞架 → 蓝伞已撑开抬起，露出抱箱的大叔 |
-| T02 | S04–S06 | 15 秒 | 挡雨、扶门与入店构成连续帮助过程；全片结束 | 阿林持撑开的伞，大叔在雨中抱箱 → 大叔入店，阿林收伞，小雨扶门微笑 |
-
-### T01 · 从拿伞到看见伞下的人
-
-```text
-9:16 竖屏，写实生活短片，自然表演，总时长 15 秒。
-白天下雨的便利店入口，门内暖光，门外阴雨自然光。向外开的玻璃门旁，门内右侧伞架有一把收起的蓝伞。室外是无顶棚的湿润人行道。
-阿林是黑色短发、偏瘦的年轻男性，穿灰色连帽卫衣和深色牛仔裤。小雨是圆脸、黑色齐肩直发的年轻女性，穿米色风衣、白色内搭和黑色长裤。阿林站在右侧伞架旁，小雨站在门内后方。送货大叔是短发方脸的中年男性，穿深蓝工作服和黑色工作鞋，双手抱一个棕色纸箱，在门外离入口两步远处站着，初始被门框和构图遮挡，站位避开门的摆动范围。
-0～5 秒：固定中景，阿林从伞架拿起蓝伞，望向门外，平常语气说：“借一下。”小雨的视线落到他拿伞的手上。门框和构图遮住室外等待的人，不提前揭示帮助对象。
-5～10 秒：切到小雨近景，她皱眉，伸手想叫住阿林；焦点转向门口，阿林推门跨出，在室外开始撑开蓝伞。
-10～15 秒：从小雨所在的门内位置向外拍，镜头轻微侧移。阿林撑开并抬起蓝伞，伞面移开后，观众第一次清楚看见抱着纸箱站在雨中的大叔。大叔双手一直抱箱，腾不出手。
-结束时阿林在门外持着已撑开并抬起的蓝伞，尚未移到大叔头顶；大叔在雨中抱箱，小雨在门内，手仍停在想拦人的半空。保留雨声、脚步声和伞骨展开声。对白只由阿林说出，不加旁白或音乐。
-不生成对白字幕、解释性叠字或标题卡。
-```
-
-### T02 · 把拦人的手变成扶门的手
-
-```text
-9:16 竖屏，写实生活短片，自然表演，总时长 15 秒。
-白天下雨的便利店入口，门内暖光，门外阴雨自然光。玻璃门向外打开，门外是无顶棚的湿润人行道。
-小雨是圆脸、黑色齐肩直发的年轻女性，穿米色风衣、白色内搭和黑色长裤，站在门内，手还停在想拦人的半空。阿林是黑色短发、偏瘦的年轻男性，穿灰色连帽卫衣和深色牛仔裤，站在门外，手中蓝伞已撑开并抬起，尚未移到送货大叔头顶。送货大叔是短发方脸的中年男性，穿深蓝工作服和黑色工作鞋，双手抱一个棕色纸箱，在雨中距离入口两步，尚未入店。
-0～5 秒：门外中近景，阿林把蓝伞移向大叔头顶，覆盖大叔和箱子，让自己的半边肩膀留在雨里。大叔看向阿林，轻轻点头。
-5～10 秒：切门口中景，小雨看清情况后收回拦人的手，迈到门边，撑住向外开的玻璃门，给大叔留出入口。她自然地说：“我来扶。”大叔抱箱向门内迈步，阿林持伞跟随半步，伞保持在室外。
-10～15 秒：固定中景，大叔跨过门槛进入店内，朝小雨点头。阿林留在门外收起蓝伞。小雨仍扶着门，与阿林相视一笑，用这个短暂停顿收尾。
-结束时大叔和箱子已在店内，小雨扶门，阿林在门外拿着收起的蓝伞。保留雨声、脚步声和收伞声。对白只由小雨说出，不加旁白或音乐。
-不生成对白字幕、解释性叠字或标题卡。
-```
-
-## 制作备注
-
-计划总时长 30 秒，6 个镜头，每镜 5 秒；用户选择单段上限 15 秒，形成 2 个生成段，每段 15 秒。镜头按顺序完整分配，未重复使用。对白共两句，留有动作时间。
-
-独立提示词已展开人物和起始状态，但跨段人物外观、伞与门的位置仍需要实际生成后检查。此示例未执行视频生成，不代表模型能精确还原全部镜头。

package/skills/qisi-video-remix/references/delivery-guide.md

@@ -1,63 +0,0 @@
-# 交付格式
-
-以下是默认展示顺序，可随作品长度调整。不要输出空模板。短片通常一份文稿足够；没有对白或人物时省略无用栏目。
-
-## 1. 本次方案
-
-用一行列明片名、预计总时长、用户选择的单段时长上限（15 秒或 30 秒）、比例和风格。另一行说明采用了哪些默认设置以及参考材料覆盖范围。不要把缺失证据藏到文末。
-
-## 2. 参考与改编思路
-
-简述原片可确认的故事，附关键证据定位。随后分别说清借用了什么叙事方法、改动了哪些事件和人物选择。分析只写对创作有用的内容。
-
-## 3. 完整剧本
-
-按场次写能顺着读下来的故事：地点和时间、人物行动、明确说话人的对白、转折和收尾。让用户先判断故事是否成立，不必先读分镜技术字段。
-
-## 4. 人物与场景
-
-人物表包含名称、稳定外貌、本片造型；场景表包含名称、空间关系和关键物件。表格后必须输出三类生图提示词：每个人物的身份参考图、每套出镜造型的参考图、每个场景的参考图。无人作品省略人物类，用户明确要求省略时遵循其要求。
-
-每条提示词使用独立代码块，标题对应资产名称。身份图用清楚呈现面容的构图，造型图用可看全服装的全身构图，场景图明确视频比例与空间布局、默认无人物。各条展开必要外貌与风格描述，不依赖名字、ID或“同上”。未提供身份图时不能声称已绑定图片；实际有图可用时才说明如何引用。
-
-提示词用于生成单张参考图，不要求一次生成拼贴、带标签的角色板或文字说明。保持各类图片的视觉风格与视频方案一致。这一节交付的是文字提示词，不自动调用生图服务。
-
-## 5. 分镜表
-
-建议列：镜头、全片时间／时长、人物造型与场景、画面和运镜、对白与声音。用 `00:00–00:06／6 秒` 消除“时间点还是时长”的歧义。描述复杂时把镜头详情放到表格下，避免宽表难读。
-
-对白写明说话人；旁白和画外音标明来源。涉及物件传递、视线或动作方向时写清对象，避免“他看着他”这种无法制作的指代。
-
-## 6. 生成分段
-
-用户未选择 15 秒或 30 秒上限时先询问，不代选。先按场景、造型、时间层及动作复杂度判断镜头兼容性，再按有效上限组段。所有段都可短于上限，标出实际秒数，不为凑整加戏或减少段数而强行合并。
-
-先给总览表：生成段、覆盖镜头、实际时长、切分原因、起始→结束状态。然后每段配一个独立可复制代码块。标题和外部表格可以使用编号，代码块内部需要把身份、造型、场景和对白展开。
-
-段内时间从 0 秒起算。默认使用普通文字提示词，不添加工具专属参数或未解析占位符。参考结构：
-
-例如全片 60 秒、用户选择 30 秒上限，内容需要四个独立生成单元时，可这样分配：
-
-| 生成段 | 全片范围 | 实际时长 | 切分原因 |
-| --- | --- | --- | --- |
-| T01 | 00:00–00:12 | 12 秒 | 室内争执结束，下一镜转到车站 |
-| T02 | 00:12–00:30 | 18 秒 | 车站告别结束，下一镜跳到多年后 |
-| T03 | 00:30–00:44 | 14 秒 | 新年龄造型下的发现过程结束，后续复杂互动独立生成 |
-| T04 | 00:44–01:00 | 16 秒 | 重逢互动与结尾 |
-
-这是示意分配，实际时长由已定分镜相加得到。不能因为 60÷30＝2 就强制只输出两段。
-
-```text
-画面比例和风格，总时长。
-本段人物的外貌和服装。场景布局、光线、重要道具的初始状态。
-0～若干秒：景别、运镜、行动、说话人和准确对白、声音。
-后续时间：同样按动作需要组织。
-结尾：动作完成到什么状态，人物和道具停在哪里。
-声音及字幕要求。
-```
-
-提示词允许重复人物特征，这是独立使用所需。不要重复与本段无关的剧情。生成模型未指定时，仅称为制作规划，不承诺某模型能按整段精确生成。
-
-## 7. 制作备注
-
-简短报告预计总时长、镜头数、分段数以及未解决的具体问题。字幕若需精确排版，可计划在剪辑阶段添加；不要把策划阶段描述成已经生成了视频或字幕文件。

package/skills/reel-video/SKILL.md

@@ -1,237 +0,0 @@
----
-name: reel-video
-description: "Reel Video: the method the original skill taught, run as an AICUT film — pages that draw any moment t, cut on tracks. Runs in AICUT: the film is film.html, a page per shot, drawn by `aicut look` and `aicut render`."
-license: MIT
-source: "AsadMoulviDev/reel-video"
----
-
-# Reel Video
-
-## Running it in AICUT
-
-AICUT's film is `film.html`: it cuts pages, footage, pictures and sound together on tracks. A page is a web page that
-sets `window.film = { frame(t) }` and draws that moment — no framework, no build step, no composition object, no
-`registerRoot`. Five shots are five pages cut together, not one page that changes scene, so each shot stays trimmable
-and replaceable in Studio.
-
-```sh
-npx -y @autoaiai/aicut@latest          # the manual: the format and the commands, always current
-npx -y @autoaiai/aicut@latest open .   # make this folder a film and print Studio's address
-npx -y @autoaiai/aicut@latest look     # a contact sheet of the whole film, its sound, and a determinism check
-npx -y @autoaiai/aicut@latest look 4.5 # one frame, full size — look at the PNG, not at the code
-npx -y @autoaiai/aicut@latest render   # the MP4, beside film.html
-```
-
-Run the manual before the first film: it is authoritative for the format, and this skill is about the method above it.
-
-Where the words below name another program's part, it becomes this:
-
-| elsewhere | in AICUT |
-|---|---|
-| composition, timeline, project file | `film.html`; tracks and clips inside it |
-| a scene, a sequence, a slide | a page (`pages/<name>.html`) cut onto a track |
-| `useCurrentFrame()`, `interpolate()` | `frame(t)` — the picture depends only on `t`, never on state or `Date.now()` |
-| a still, a screengrab | `aicut look <t>` |
-| `render` / `build` / `export` | `aicut render` (the person can also export from Studio) |
-| a dev server, a preview window | `aicut open` and the Studio address it prints |
-
-Hard rules that hold whatever the method says: the picture depends only on `t`; every value in the person's prompt is
-binding; look at the frames `look` writes before saying a film is done.
-
-
-Agent-operated short-video canvas. CLI + local review UI. Auth is **CLI login**
-(`grok login`, optional `codex login`) — no API keys in the project.
-
-Repo: https://github.com/AsadMoulviDev/reel-video  
-Work from the package root (e.g. `agent-canvas/` or a clone of `reel-video`).
-
-## Non-negotiables
-
-1. **Serve the UI first; humans generate.** Prefer `canvas serve` and let the
-   user click Generate / Animate. Only run `canvas run` when they explicitly ask
-   you to generate, or when scaffolding empty pending shots they will run later.
-2. **Never invent infra.** No tunnels, no public PUT servers, no `--yolo` with a
-   shell to “just make the video appear.” See `docs/zdr.md`.
-3. **Narrow tools only.** Generation goes through the canvas runner (Grok:
-   `image_gen` / `reference_to_video`; Codex: constrained `codex exec`). Do not
-   hand the model a free terminal for media jobs.
-4. **Video duration is only 6 or 10 seconds.** Long stories = multiple scenes.
-
-## Mental model
-
-```
-Storyboard (1 multi-panel still — the visual bible)
-  └── Scene (~6s story beat)
-        ├── first frame   (full frame still, refs storyboard)
-        ├── middle frame  (full frame still, refs storyboard)
-        ├── last frame    (full frame still, refs storyboard)
-        └── video         reference_to_video([first, mid, last])
-```
-```
-| Piece | File type | Role |
-|---|---|---|
-| Storyboard | One image | Full plot, multi-panel (e.g. 8 panels). Style + character lock. |
-| Scene | Grouping | One ~6s chapter of the story (e.g. panels 1–4). |
-| 3 frames | Three images | First / mid / last of that scene — what the video model can use. |
-| Video | One mp4 | Morphs the three stills in order. **Does not accept video as input.** |
-
-`reference_to_video` takes **2–7 images only**, not `.mp4`. Continuity for later
-boards uses **prior stills** via `--refs`, never prior videos.
-```
-
-## Setup (once per machine / account)
-
-```bash
-grok login          # images + video
-codex login         # optional stills provider
-```
-
-# Video often requires coding-data retention Opt in (account setting):
-
-# Interactive only — not grok -p:
-grok
-
-# then: /privacy  →  Coding data, retention, and training → Opt in
-```
-If video fails with `output.upload_url` / ZDR text, re-check `/privacy` or
-configure `tools.zdr_video_output_s3` in `~/.grok/config.toml` (see `docs/zdr.md`).
-```
-
-## Standard workflow
-
-### 1. Init + UI
-
-```bash
-npm run canvas -- init "my short"
-npm run canvas -- serve --port 4180   # open browser; restart after code changes
-```
-```
-After any code change that affects serve/UI, **restart serve** and tell the user
-to refresh.
-```
-
-### 2. Storyboard (master board)
-
-Prefer **Codex** for multi-panel boards when the user wants that; otherwise Grok.
-
-```bash
-npm run canvas -- add image --provider codex --aspect 16:9 --id img-1 \
-  --prompt "ONE single image: N-panel storyboard grid … consistent character … style … NO text, NO watermark"
-npm run canvas -- storyboard set img-1
-```
-```
-Prompt rules for boards:
-- Explicitly **one image**, multi-panel layout (e.g. 2×4 for 8 panels).
-- Number panels and describe each beat left-to-right, top-to-bottom.
-- Style lock phrase (Pixar, live action, etc.) and “same character in every panel”.
-- Forbid text, captions, speech bubbles, watermarks.
-
-User generates the board in the UI (or `canvas run --shot img-1` if asked).
-```
-
-### 3. Scenes (3 frames + video)
-
-```bash
-npm run canvas -- scene add --name "Ride and trip" --panels 1-4 --provider codex --duration 6
-```
-```
-Optional overrides: `--first-prompt`, `--middle-prompt`, `--last-prompt`,
-`--video-prompt`, `--storyboard img-1`.
-
-This creates:
-- three image shots with `refs: [storyboard]`, `frame: first|middle|last`
-- one video with `from: first`, `refs: [middle, last]`
-
-**Do not invent free-floating keyframes** without the storyboard as ref when
-continuing a story — style will drift.
-```
-
-### 4. User generates
-
-Order in UI / run:
-1. Storyboard ready  
-2. Scene frames (first, mid, last)  
-3. Scene video  
-
-Status: `npm run canvas -- status`.
-
-## Prompt recipes
-
-### Scene frame (always ref storyboard)
-
-```
-SINGLE cinematic frame (NOT multi-panel). FIRST|MIDDLE|LAST FRAME of scene "<name>".
-Use attached storyboard as ONLY style/character reference — match exact design.
-This frame = <beat>. Full shot. NO panels, NO text, NO watermark.
-```
-
-### Scene video (three stills in order)
-
-```
-Animate continuous N-second shot using three reference stills IN ORDER:
-first = start, second = middle, third = end of scene "<name>".
-Morph smoothly first→mid→last. Match characters/world from the stills.
-Clear beats, no on-screen text.
-```
-
-### Continuity / next board
-
-```bash
-npm run canvas -- add image --provider codex --refs img-1 --prompt "ONE image, 4-panel grid, CONTINUATION of attached board…"
-```
-
-## Commands cheat sheet
-
-| Command | Purpose |
-|---|---|
-| `canvas init [name]` | Create `canvas/project.json` |
-| `canvas storyboard set <img-id>` | Mark master board |
-| `canvas scene add --name … [--panels …]` | Scaffold 3 frames + video |
-| `canvas add image … [--provider codex\|grok] [--refs a,b]` | Free image |
-| `canvas add video --from <id> [--refs a,b] [--duration 6\|10]` | Free video |
-| `canvas set <id> --prompt …` | Edit prompt (marks pending) |
-| `canvas rm <id>` | Remove shot (blocked if scene-wired) |
-| `canvas run [--shot id] [--force]` | Generate (only if user asked) |
-| `canvas status` | Structure + shot states |
-| `canvas serve [--port 4180] [--no-open]` | Review UI |
-
-`--json` on any command for machine-readable output.
-
-## UI rules
-
-- UI groups: **Storyboard** block, then each **Scene** (first/mid/last + video).
-- Asset URLs are content-addressed; never cache-bust with `Date.now()`.
-- After serve restarts, tell the user to **refresh** the browser.
-
-## Failure playbook
-
-| Symptom | Action |
-|---|---|
-| Video: `output.upload_url` / ZDR | `grok` → `/privacy` → Opt in; or `docs/zdr.md` R2 config |
-| Codex: `No prompt provided via stdin` | Ensure package has stdin-based prompt pass (codex.ts); restart serve; `codex login` |
-| Codex wrote no image | Check `codex login`; re-Generate; inspect shot message |
-| Style drift on new board/frames | Must use `--refs <storyboard>` / scene scaffolding |
-| Video ignores board | Use three **scene frames** as refs, not only the multi-panel grid |
-| Want longer than 10s | Add another **scene**, do not fight duration enum |
-
-## Anti-patterns
-
-- Running full `canvas run` unprompted while the user is driving the UI  
-- Feeding **video files** into `reference_to_video`  
-- Generating scene frames **without** storyboard refs  
-- One video for an 8-panel arc without splitting into scenes  
-- Standing up tunnels or public upload endpoints for ZDR  
-- Committing `.env` or `canvas/assets/` to git
-
-## When to read more
-
-- `README.md` — install, requirements, commands  
-- `docs/zdr.md` — privacy, ZDR, R2  
-- `docs/design.md` — why list + SSR UI, not React Flow
-
-## Source
-
-Rewritten for AICUT from [`AsadMoulviDev/reel-video`](https://github.com/AsadMoulviDev/reel-video)
-(MIT), .claude/skills/reel-video/SKILL.md. The method is that skill's own; the way it runs is AICUT's.
-
-The repository holds 2 skills; this is the one its entry stands for.