用途
Opus Video Skills 是两套 Opus 5.5 代码视频工作流的选择与接入导航，帮助用户根据需求选用 painted-animation 或 kinetic-reel，并了解安装、故事板、逐帧构建、声音同步与渲染审查的基本流程。完整模板、渲染器、示例与脚本位于上游仓库，本目录只收录浓缩规范与预览。
主要能力
painted-animation 基于 p5.js + p5.brush，用于水彩/水墨角色短片、MV、歌词视频与循环动画。其视觉约束包括使用 paint()、inkLine() 等笔刷语言，保持平面 2D，默认不用画面文字讲故事，每个镜头要有事件与因果，并设计镜头转场。
kinetic-reel 基于 Canvas 2D + three.js/WebGL，用于动态排版、作品集、产品/片头 Reel 与合成配乐。其约束包括以字体为主角、用视觉机制证明标题、章节时长按 brief 分配、剪辑与字形对齐 hits、事实数字来自用户材料，并对示意内容明确标记 SCHEMATIC。
使用方式
先确认 brief 与上游环境，包括主题、时长、比例、重点内容、事实来源、语言与已有素材；歌词视频需要歌曲文件和 LRC，作品集需要真实项目材料与篇幅分配。然后安装上游插件：
/plugin marketplace add tuzhechen2005/opus-video-skills /plugin install painted-animation@opus-video-skills /plugin install kinetic-reel@opus-video-skills
需要 Node.js、Google Chrome、FFmpeg；仅 painted-animation 的速度检测额外需要 Python 3 + numpy。之后按所选 Skill 的脚手架创建工程并读取完整指南。
在工程内建立 STORYBOARD.md，写入时长预算、视觉母题、统一线索、每镜头机制/事件、转场和声音；角色片增加情绪弧线与关键姿势，Reel 增加事实来源、章节比例与 HUD 信息层级。除非用户明确要求直接制作，先让用户对故事板反馈。
逐帧构建时，每帧是时间 t 的纯函数，整帧可独立、乱序渲染，禁止墙钟、未播种随机数、计时器和跨帧状态。手绘片每场景一个 IIFE，先关键姿势再补动作；Reel 用 cues.js 统一场景开始、节拍、章节与总时长，配乐从同一时间数据生成。音乐、歌词、音效和画面读取同一时间数据，音效对齐实际瞬态，合成音频也要做响度与峰值检查。
渲染审查阶段，每镜头至少一张 contact sheet，关键动作/转场加时间带，承载剧情的表情或密集排版加全分辨率裁切，实际打开图片检查并修复后重渲。短视频可单进程；长视频并行逐帧渲染、可恢复，再由 FFmpeg 编码。音频单独修改时优先重混/复用已验证画面。最终解码 MP4 再检查接缝、字幕、空帧、音画同步、分辨率、时长与音频。
适用场景
需要手绘短片、角色 MV、卡拉 OK 逐字歌词、motion reel、kinetic typography 或程序化配乐视频时，可根据需求选择对应风格；只需其中一种风格时，仅安装对应 Skill。
限制
painted-animation 不适合大量正文排版、数据仪表与真实 3D；kinetic-reel 不适合柔软角色演技、水彩材质与长对白剧情。本目录不复制 template/、render.mjs 或示例工程。上游为 MIT 许可；painted-animation 引擎/指南及 kinetic-reel 渲染器包含 John Heibel 的 ClaudeAnimationBase 派生内容，复用时需保留其版权与 MIT 说明。p5.js、p5.brush、three.js、Puppeteer、FFmpeg、字体、歌曲和用户素材分别适用各自许可。