general-video作者 HeyGen

General Video Skill.

Claude Code 和 Codex 的动效与视频 skill：当没有合适模板时，创作或编辑自定义多场景 HyperFrames 视频。

Motion & Video
Video

heygen-com/hyperframes · skills/general-video/SKILL.mdSKILL.md

--- name: general-video description: Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using … --- ## 1. Apply cross-cutting source adapters ## 2. Start from project state ## 3. Interpret the run shape ## 4. Load required knowledge before each stage ## 5. Execute the composition ## 6. Gates that always apply

前言和章节标题读取自上游文件，时间为 2026-09-14 · 完整内容 20,760 字符

01 功能说明

general-video Skill 在 Claude Code 和 Codex 中的作用

摘要、工作流与产物，均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

编写或编辑自定义 HyperFrames 组合，用于多场景视频、品牌短片、蒙太奇、素材混剪、静态循环、片头卡，以及在没有专用工作流模板适用时的自由构建。同时支持自动化流程（Agent 选择并执行路径）和协作流程（在对话中共同创作，进行导演级的编排规划）。

处理从场景规划到分镜脚本、带可选 worker 派发以支持规模化的多场景组装、媒体操作集成，并保持确定性的合成契约。适用于较长的作品或已发布工作流不适用的自定义构建。

它产出什么

每个场景对应的 compositions/<frame_id>.html，包含带时间控制的片段元素、已设置尺寸的根节点，以及 window.__timelines 上一条已暂停的可安全跳转的时间线
compositions/<frame_id>.motion.json 附属文件，携带每个场景的时长以及出入场向量
STORYBOARD.md，每个场景一个 Frame N 区块，包含状态、src、蓝图/规则引用及节拍文本
用户在最终 Studio 预览通过后验证的已渲染视频文件

查看示例提示词 ↗

工作方式

01
应用 Source Adapters
针对任何音频、图像、语音、调色或字幕需求，加载 media-use。如果输入是 Figma URL，先运行 Figma skill 以导出素材、token 和分镜帧。
02
从 Project State 开始
对于特定编辑，直接进行更改并保留已有决定，无需重新展开探索。对于全新创建，先运行 hyperframes 意图层。
03
解读 Run 结构
从 BRIEF.md 中读取 flow（自动化或协作）、storyboard（是或否）以及派生的 mode。自动化会选择路径；协作则共同创作。
04
执行合成阶段
结合引用的 blueprint 或规则规划观看弧线。在构建任何具名效果前，先在实时 catalog 中搜索。解析依赖并安装 registry 区块。
05
组装并验证
挂载场景、素材、转场、字幕和音频。在人声轨下铺垫音乐床。首次 HTML 通过后运行 lint，最终关卡再运行 hyperframes 检查。
06
确认并渲染
仅在检查通过后打开最终的 Studio 预览。询问是渲染还是修改。仅在用户确认后才渲染。

02 找到适合场景

何时使用 general-video Skill

当工作是此类动效与视频时，在 Claude Code 或 Codex 中使用 general-video skill。下方的适配性和限制来自 skill 自己的文件。

适合场景

较长或多场景作品，包括品牌与精华混剪、蒙太奇、静态循环、静态标题卡和素材重混
当没有专用工作流模板适合项目需求时的自定义自由构建

了解边界

短小无旁白、以动效为主的单元（包括动画标题）应改用 motion-graphics 工作流
全新的创作请求应先经过 hyperframes intent 层，而不要直接进入此 skill

需要提供的信息

BRIEF.md当 brief-format.md 存在时，使用它来编写。包含工作流、flow、storyboard 偏好以及已确认的字段。
Figma URLs输入任何 figma.com 网址都会先触发 Figma skill，用于导出素材、token、组件或 storyboard 帧。
Existing project state当 hyperframes.json 或 STORYBOARD.md 存在时，从中恢复。仅根据已知事实回填 BRIEF.md，而不再提出 brief 问题。

03 Skill 内部

general-video Skill 为 Claude Code 和 Codex 设定的规则

SKILL.md 为 Agent 设定的 5 条具体指令、默认值与限制——文件中真正改变结果的那一部分。

构建效果前先搜索 Catalog
在计划自行构建任何具名效果之前，先用简单的英语描述该效果，运行 npx hyperframes catalog --query。
小规模下内联比派发更快
约 6 个短场景以内，在同一上下文中内联构建更快（实测：5 个场景内联约 9 分钟，分包处理约 21 分钟）。
硬切使用重复素材源
对现有素材进行硬切、修剪、拼接或重排时，将同一视频源重复放入多个 clip 元素。
仅构建精确范围
精确构建用户所要求的内容。标题卡就是标题卡，不是标题卡加三个场景、音乐和字幕。添加内容前先征询意见。
先设计，后 HTML
按顺序确定设计来源：frame.md，然后 design.md，然后 DESIGN.md。

04 投入使用

在 Claude Code 或 Codex 中安装 general-video

一条 npx skills add 命令，然后在你的 Agent 中执行第一个任务和对结果的清单检查。

将 general-video 添加到 Claude Code、Codex 或你的 Agent

在你的项目中运行；安装程序会询问要把它添加到哪个 Agent。

Terminal

npx skills add https://github.com/heygen-com/hyperframes --skill general-video

针对 skills/general-video/SKILL.md 的通用 skills CLI 形式；仓库可能会记录其自身的路径。

给 Skill 一个首次动效和视频任务

按 skill 自身的术语撰写；把括号中的部分换成你的内容。

Starter prompt

Create a 90-second brand sizzle reel for [company name] using [uploaded footage folder]. Open with their logo reveal, follow with four product highlight scenes showing [feature A], [feature B], [feature C], and [customer testimonial clip], then close with a call-to-action card displaying their tagline and website. Use their brand colors from [design.md] and add background music that feels energetic and modern. Include lower-third captions for the testimonial.

来源：依据 SKILL.md，按 skill 自身的术语撰写。

检查首次结果

SKILL.md 本身如何描述正确的结果：

运行 npx hyperframes check 作为最终关卡，它会在内部重新执行 lint 并进行额外的验证
检查子合成的中间快照，以验证场景渲染
使用 hyperframes-animation/scripts/animation-map.mjs 审查动画映射，用于多场景工作
存在设计规范文件时，对照 design-adherence.md 审查设计遵循情况

在 OpenDesign 中通过其 SKILL.md 链接导入 general-video：Plugins → Add → Skill → Import from link，然后在顶部栏中选择它。

下载 OpenDesign 阅读快速入门

05 开源、可追溯

来源、许可与验证

本页面事实的来源，以及最后检查时间。

Author: HeyGen
Repository: github.com/heygen-com/hyperframes 分支 main
Skill 文件: skills/general-video/SKILL.md 验证时记录的内容校验和；提交 558c11b
License: Apache-2.0 来自 LICENSE。
仓库星标数: 49,761 GitHub 快照拍摄于 2026-09-14，针对整个 heygen-com/hyperframes 仓库，该仓库在此目录中包含 9 个 skills。不是 general-video 的评分或使用计数。
已由 OpenDesign 验证: 2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序（检查日期 2026-08-28）；本页面未记录实际运行。

SKILL.md 内部

General video开始任何工作前的介绍与 skill 更新命令要求
1. 应用跨领域来源适配器加载 media-use 以处理素材和操作；对任何 Figma URL 输入运行 Figma skill
2. 从项目状态开始匹配当前状态：具体编辑、现有 brief、从文件恢复，或全新创建脚手架
3. 解读运行形态从 brief 合约中读取流程自动化或协作模式、有无分镜脚本，以及派生模式
协作流程以导演身份介入，采用上限处理方式，在检查点之间升级通道，并立即记录已接受的能力
4. 在每个阶段前加载所需知识将必读表条件与所需参考资料匹配，包括核心、创意、动画、分镜脚本、素材、制作
5. 执行合成七阶段依赖顺序：规划、审查、解析、构建场景、合并动效、组装、验证、最终批准
严格保持范围只构建用户所要求的内容；在添加任何附加内容前先提出建议
先设计，后 HTML确定设计来源顺序；无设计规范时，需完成四项内容后再编写 HTML
保持合成合约定时元素使用 class clip，root 已定尺寸，单一暂停时间轴，无网络请求的确定性渲染
安全借用工作流从相似工作流中借用并更新其类型参照与审美倾向，而非其私有脚本或合约
7. 完成运行完整检查清单：范围已实现、检查已通过、遵循情况已审查、快照已检查、预览已批准、渲染已验证

Skill 自身的描述

"当没有专门工作流适配，或当 BRIEF.md 设置 flow: companion 时，创作或编辑自定义 HyperFrames 作品。用于较长或多场景作品、品牌和宣传片、剪辑集锦、静态循环、静态标题卡、素材混剪和自由构建。对于短的无旁白的动效优先单元（包括动画标题），改用 motion-graphics。在使用此 skill 前，将新创作路由到 hyperframes。"

来自 SKILL.md 的前置描述。完整文件约 20,760 个字符。在 GitHub 上阅读完整文件。

06 安装之前

关于 general-video Skill 的常见问题

以下回答来自 2026-09-14 读取到的 SKILL.md，而非某次实际运行的记录。

使用此 skill 是否需要 HeyGen 账户或登录？

身份验证取决于流程设置和所需能力。在首次进行需要身份验证的提供方操作之前，该 skill 会运行 npx hyperframes auth status。对于协作流程，它会等待登录或明确选择离线模式。

对于自主流程，它会说明状态并继续通过可用的离线提供方运行。只有在没有任何离线提供方能满足所需能力时，才会呈现阻塞提示。

General Video

在真实的动效和视频任务上运行 general-video。

下载 OpenDesign，从其 SKILL.md 链接导入 general-video，粘贴上述提示，并在结果前阅读计划。

下载 OpenDesign 浏览所有 skills

终端

npx skills add https://github.com/heygen-com/hyperframes --skill general-video