Video Ninja
跳跃技能 — 主调度器，可将视频任务路由到来自10个仓库和1个知名来源的79个全局安装技能，以及本地同步仓库中的解剖学和DaVinci Resolve剪辑技能，再加上一个从 My-Little-Studio 流程中提炼出的方法论层。
此 ninja 可将任何视频任务路由到已安装或本地同步的技能。它是必需的入口点：在选择视频技能之前，请先阅读本文。
为什么需要这个 ninja
十个全局安装的源仓库涵盖了渲染、媒体处理、工艺、框架、动画库、艺术风格和3D图形子系统，但每个都是一个孤岛。 HyperFrames 可以渲染视频，但它对质量问题没有发言权。motion-video-kit 有一套质量方针，但没有渲染器。Remotion 是一个替代框架，而不是 HyperFrames 的插件。opus-video-skills 带来了独特的视觉效果，如水彩画和动态文字排版，但不具备其他仓库的工艺方针。 ffmpeg-skill 处理现有素材；它不从头构建构图。gsap-skills 教授正确的 GSAP 模式，但它不是一个视频引擎。dotlottie-web 处理 Lottie 资产，但不将它们组合成视频。Three.js 套件提供高级的3D图形子系统，但它既不规划也不交付一部影片。
这个 ninja 是一个选择和连接它们的层，并跟踪生态系统仍然缺少什么。
黄金法则
/hyperframes是视频创建和构图的默认入口点。 它会在10个工作流中进行选择，并按需加载领域技能。对于必须在 DaVinci Resolve Studio 中构建的素材剪辑，请改用可选的video-editor-skills路由。 这个 ninja 不取代 HyperFrames 的路由功能；它告诉你去使用哪个层以及什么时候仅靠 HyperFrames 是不够的。
对于视频创建、动画、构图和渲染，请从 /hyperframes 开始。对于应在 Resolve Studio 中构建的 talking-head、vlog 或课程时间线，请使用受限的 video-editor-skills 路由。其他例外包括 Remotion、屏幕录制、工艺方针、流程方法，以及 references/youtube-video.md 中描述的 YouTube 视频指导。
全局安装的源仓库
| 仓库 | 技能数 | 层级 | 状态 |
|---|---|---|---|
heygen-com/hyperframes | 27 | 渲染器 + 领域技能 | 已安装，Apache-2.0 |
kajisho5/ffmpeg-skill | 1（42个工具） | 媒体处理 | 已安装，MIT |
echris6/motion-video-kit | 1 | 质量方针 | 已安装，MIT |
remotion-dev/skills | 12 | 替代框架 | 已安装 |
Rieranthony/product-film-skill | 1 | 屏幕录制 | 已安装，MIT |
tugrawork-creator/saas-motion-kit | 1 | 多样性与防重复 | 已安装 |
tuzhechen2005/opus-video-skills | 2 | 程序化艺术风格 | 已安装，MIT |
greensock/gsap-skills | 8 | 官方 GSAP 技能：时间线、ScrollTrigger、插件、React | 已安装，MIT |
LottieFiles/dotlottie-web | 1 | 现代 Lottie 播放器：Rust+WASM、状态机、主题 | 已安装，MIT |
scottstts/Threejs-Awesome-Graphics-Agent-Skills | 24 | 高级 Three.js 图形子系统 | 由它自己的安装程序安装；已从同步中排除（约261 MB），MIT |
全局安装技能的来源记录在 ~/.agents/.skill-lock.json 中。Three.js 套件是个例外：它自己的安装程序（npx threejs-awesome-graphics-agent-skills@latest install --agent universal）将技能安装到 ~/.agents/skills/ 中，没有 lockfile 条目。fframes-video 通过 fframes.studio 单独安装。
本地同步的源技能
| 仓库 | 技能 | 角色 | 许可证 |
|---|---|---|---|
wheresryan22/anatomy | anatomy | 用于解释性内容的等角技术图形 | MIT |
appariciojunior/video-editor-skills | 12个技能 | 在 DaVinci Resolve Studio 中进行可选的初剪辑 | CC BY-NC 4.0；仅限非商业用途 |
两者都在根目录的 repos.md 中声明，并同步到 repos/video-ninja/ 下，以便 Ninja 在需要时加载它们的说明。参见 references/repos.md。
电影风格库与角色套件
| 仓库 | 添加内容 | Ninja 如何使用 | 许可证 |
|---|---|---|---|
lemomo-ai/lemo-opuscar | 66种用代码实现的电影风格，每种都带有演示影片、STYLE.md 和导演指南 | 通过 lemo-opuscar 技能（Claude 插件），该插件在 ~/lemo-opuscar 中维护自己的稀疏库。未同步（约195 MB） | MIT 代码；演示影片 CC BY 4.0 |
Vincentwei1021/mg-styles-15 | 15种动效设计风格，包含完整的提示、源代码、渲染器和审核标准 | 按需稀疏检出 prompts/、harness/ 和 lib/。未同步（约1.2 GB） | MIT |
JohnHeibel/ClaudeAnimationBase | p5.brush 手绘角色套件：31种情感、视角、手势、帽子、联系表审阅 | 本地同步到 repos/video-ninja/ClaudeAnimationBase/；阅读其 ANIMATION_GUIDE.md | MIT；关于 Claude 的视频中仅限使用 Clawd，否则请使用您自己的角色 |
家族、风格、安装步骤和许可证说明：references/film-families-and-styles.md。
单独安装的技能
| 来源 | 技能 | 角色 | 安装 |
|---|---|---|---|
fframes.studio | fframes-video | 替代性 Rust/SVG 渲染器，支持 Skia GPU、FFmpeg 和代理可读的质量检查 | 知名，全局安装 |
已评估但未安装的外部工具
| 来源 | 角色 | 何时考虑使用 | 状态 |
|---|---|---|---|
m-bain/whisperX | 本地 ASR，支持词级时间戳和说话人分离 | 需要单词时序或说话人识别的 talking-head、访谈或播客工作 | 可选后端；未安装。参见 references/whisperx.md |
airbnb/lottie-web | 用于 After Effects Lottie 动画的播放器 | 在 HyperFrames 构图中复用项目提供的 .json Lottie 资产 | 按需依赖；未由 Ninja 安装。参见 references/lottie.md |
ManimCommunity/manim | 用于数学动画的 Python 引擎 | 需要另一个渲染器和适配器的周期性数学解释性内容 | 已评估，未安装。推文链接指向 3b1b/manim (ManimGL)。参见 references/repos.md |
rive-app/rive-wasm | 支持原生状态机的交互动画 | 项目包含来自 Rive Editor 的 .riv 资产，或需要能响应应用状态的动画 | 按需依赖。参见 references/rive.md |
goldfire/howler.js | 网页音频控制：音频精灵、淡入淡出、空间音频 | 需要精确时序、音频精灵、3D位置音频的音效 | 按需依赖。参见 references/howler.md |
vercel/satori | JSX → SVG，用于标题卡和缩略图 | 从数据批量生成标题卡、缩略图或文字密集型图形 | 按需依赖。参见 references/satori.md |
解剖学产生的是一项视觉资产或场景，而非完成的视频。其源代码同步在 {{JUMP_SKILLS_DIR}}/repos/video-ninja/anatomy/；当路由到它时，请阅读该仓库的 SKILL.md。构建并检查图形，然后将输出带入 /hyperframes 并遵循动态、构图和渲染的规范。如果路径缺失，则将解剖学视为不可用，并使用 references/anatomy.md 中描述的备用方案。
不要假设 WhisperX 或 Manim 已安装或可用。Lottie 是一种资产格式：仅在项目已包含此类动画时才加载其播放器。
额外的参考文档
以下工具在 references 文件夹中记录，供按需使用：
| 工具 | 参考 | 用例 |
|---|---|---|
| Rive | references/rive.md | 带状态机的交互动画；当项目有 .riv 资产时替代 Lottie |
| Howler.js | references/howler.md | 网页音频控制：音频精灵、淡入淡出、空间音频；补充 /hyperframes-audio |
| Satori | references/satori.md | JSX → SVG 用于标题卡、缩略图、OG 图片；文本图形的批量生成 |
| YouTube 视频 | references/youtube-video.md | 将原始 talking-head 剪辑成精致的 YouTube 视频，并带有解释性动态图形 |
这些工具不是已安装的技能，但当需要它们的特定能力时，这些文档可供查阅。YouTube 视频行是一个流程指导，而非一个库。
另外五个流程指导涵盖了在制作构图图形时使用的资产工具：excalidraw.md（手绘图表作为视频资产）、penpot.md（带有官方 MCP 的开源设计源）、fontsource.md（用于确定性渲染的自托管字体）、lucide.md（UI 图标集）和 svgo.md（动画安全的 SVG 优化）。它们都不安装技能。
引擎映射
源图像混合了构图引擎、项目框架和文件编辑器。在选择工作流之前，请使用以下区别：
| 引擎 | 工作原理 | 何时选择 | 在 Ninja 中的状态 |
|---|---|---|---|
| HyperFrames | 在无头 Chrome 中的 HTML/CSS/JS + FFmpeg | 全新构图、动态设计和代理导向的视频 | 默认，已安装 |
| ffmpeg-skill | 探测 → 编辑 → 验证现有文件 | 剪辑、拼接、音频标准化、多机位和交付 | 处理，已安装 |
| fframes-video | 逐帧 Rust/SVG、Skia GPU、FFmpeg 和检查 CLI | 高吞吐量矢量渲染、批量工作和自动化审查 | 替代引擎，已安装 |
| Remotion | React/TypeScript，本地或 Lambda 渲染 | 现有 React 项目、构图移植或分布式渲染 | 替代框架，已安装 |
| Motion Canvas / Revideo | TypeScript 生成器；Revideo 添加了 React 播放器、无头渲染和动态输入 | Motion Canvas 用于基于编辑器的矢量动画；Revideo 用于参数化模板和 Node/无服务器渲染 | 已评估；未安装技能 |
| MoviePy | Python 片段、构图和帧效果 | 数据驱动的 Python 管道或构图原型 | 已评估；未安装技能 |
| Manim Community Edition | 用于程序化数学动画的 Python | 关于数学、图表或几何的周期性解释性内容 | 已评估；未安装技能或适配器 |
在技能定义了路由、渲染合约和验证之前，不要将 Motion Canvas、Revideo、MoviePy 或 ManimCE 作为已安装的能力呈现。如果项目已经使用了这些工具之一，Ninja 可以保留它并应用相同的动态、音频和验证规范。
在生产前检查 Remotion 的许可证：其代码是源代码可用的，免费许可证覆盖最多三人的个人和组织。较大的团队或自动化使用可能需要公司许可证。不要将其描述为 MIT 或 OSI 批准的开源。
路由
第一步 — 这真的是视频任务吗？
如果不是视频任务，则此 ninja 不适用：
| 请求 | 路由到 |
|---|---|
| 网站/应用 | impeccable，apple-design |
| 仅 UI 动画（非视频） | animate，improve-animations（Emil Kowalski 套件） |
| 仅营销文案或剧本 | copywriting，social |
第二步 — 按交付物路由
让 /hyperframes 在10个工作流中进行选择。 它的优先级表是权威的。此 ninja 仅需识别要添加的层：
| 请求 | 工作流 | 附加的 Ninja 层 |
|---|---|---|
| talking-head 中的字幕 | /embedded-captions | + /captions-overlay |
| 播客中的覆盖卡片 | /talking-head-recut | + /cut-the-curve |
| 产品或 URL 推广片 | /product-launch-video | + /motion-doctrine，/seam-craft，§产品发布 |
| 每周更新日志视频 | /changelog-video | — |
| 屏幕录制 → 演示 | /product-film（专用技能） | 参见 §Remotion |
| 商业影片（实景、AI、高端） | /business-motion-film | 参见 §规范 |
| 防重复 SaaS 推广片 | /saas-motion-video | 参见 §规范 |
| 水彩漫画 / 卡拉 OK 歌词视频 | /painted-animation | 参见 §艺术风格 |
| 动态文字排版作品集 / 展示片 | /kinetic-reel | 参见 §艺术风格 |
| 具有等角机构或对象的技术解释性内容 | 解剖学（当已同步时） | 阅读其本地 SKILL.md，构建并检查 SVG/HTML；将资产带入 /hyperframes 进行构图和渲染。参见 references/anatomy.md |
| 在 DaVinci Resolve Studio 中的 talking-head、vlog 或课程剪辑 | video-editor-skills（当已同步且许可证允许时） | 阅读其本地 skills/edit-video/SKILL.md；检查 Studio 脚本编写和商业用途条款。参见其仓库中的 CC BY-NC 4.0 和 DECLARATION.md |
...（原文截断）