Communitygithub.com

HyperFrames 视频制作技能集

在 HyperFrames HTML 中创建视频合成、动画、标题卡片、叠加层、字幕、画外音、音频反应式视觉效果和场景过渡。用于构建任何基于 HTML 的视频内容,添加与音频同步的字幕,生成文本转语音旁白,创建音频反应式动画(节拍同步、发光、脉冲),添加动画文本高亮(标记扫描、手绘圆圈、爆发线、涂鸦、草图轮廓),或在场景之间添加过渡(交叉淡入淡出、擦除、揭示、着色器过渡)。涵盖合成创作、时间线、媒体和完整的视频制作工作流程。

HyperFrames 视频制作技能集 是什么?

HyperFrames 是一个以 HTML 为视频创作核心的创新框架。本技能集为开发者、AI 代理和视频创作者提供了一套完整的工具,用于在 HyperFrames 中构建从简单动画到复杂多场景视频合成的所有内容。其核心思想是将 HTML 作为视频的“事实来源”,通过 `data-*` 属性控制时间线、使用 GSAP 动画库驱动运动,并利用 CSS 定义外观。该技能集最大的优势在于其强制性的视觉识别审查机制和“先布局后动画”的开发流程,确保了最终视频的布局准确性和视觉一致性。它覆盖了从初始创意构思、结构规划、时间布局、到最终的动画实现和场景过渡的完整工作流。支持所有主流 AI 代理平台,如 Claude Code、Cursor、Codex 等。通过遵循严格的规则(如确定性动画、禁止无限循环、精确的场景过渡逻辑),用户可以零歧义地生成高质量、可预测的视频内容。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/rbrown101010/codex-marketing-skills/tree/HEAD/plugin-workflows/hyperframes

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

预览

来自技能 README

文档

HyperFrames

HTML 是视频的真相之源。一个合成是一个带有 data-* 属性(用于控制时间)的 HTML 文件、一个用于动画的 GSAP 时间线,以及用于外观的 CSS。该框架处理片段可见性、媒体回放和时间线同步。

方法

在编写 HTML 之前,请从高层次进行思考:

  1. 是什么——观众应该体验什么?识别叙事弧、关键时刻和情感节奏。
  2. 结构——有多少个合成?哪些是子合成,哪些是内联的?哪些轨道承载什么(视频、音频、叠加层、字幕)?
  3. 时间——哪些片段驱动时长?过渡在哪里发生?节奏如何?
  4. 布局——首先构建最终状态。请参阅下面的“先布局后动画”。
  5. 动画——然后使用下面的规则添加运动。

对于小的编辑(修复颜色、调整时间、添加一个元素),直接跳到规则部分。

视觉识别门禁

按此顺序检查:

  1. 项目中存在 DESIGN.md? → 阅读它。使用其中指定的确切颜色、字体、运动规则和“不要做什么”约束。
  2. 存在 visual-style.md? → 阅读它。应用其 style_prompt_full 和结构化字段。(注意:visual-style.md 是项目特定的文件。visual-styles.md 是样式库,包含 8 个命名预设——是不同的文件。)
  3. 用户提到了一个样式(例如,“Swiss Pulse”、“黑暗且技术感”、“奢侈品牌”)? → 读取 visual-styles.md 中的 8 个命名预设。生成一个最小的 DESIGN.md,包含:## Style Prompt(一段)、## Colors(3-5 个带有角色的十六进制值)、## Typography(1-2 个字体系列)、## What NOT to Do(3-5 个反模式)。
  4. 以上都没有? → 在编写任何 HTML 之前询问 3 个问题:
    • 情绪是什么?(爆发式 / 电影感 / 流畅 / 技术感 / 混乱 / 温暖)
    • 浅色还是深色画布?
    • 是否有任何特定的品牌颜色、字体或视觉参考? 然后根据答案生成一个最小的 DESIGN.md。

每个合成必须将其调色板和排版追溯到一个 DESIGN.md、visual-style.md 或用户的明确指示。如果你正在使用 #333、#3b82f6 或 Roboto——你跳过了这一步。

对于运动默认值、尺寸、入场模式和缓动函数——请遵循 house-style.md。House style 处理事物如何移动。DESIGN.md 处理事物看起来像什么。

先布局后动画

将每个元素放置在其最可见的时刻应该处于的位置——即它完全进入、正确放置且尚未退出的帧。首先将其写为静态 HTML+CSS。还不需要 GSAP。

为什么这很重要: 如果你将元素放置在其动画起始状态(屏幕外、缩放至 0、透明度 0)并逐渐过渡到你认为它们应该着陆的位置,你就是在猜测最终布局。重叠在视频渲染之前是不可见的。通过先构建最终状态,你可以在添加任何运动之前看到并修复布局问题。

过程

  1. 识别每个场景的主角帧——大多数元素同时可见的时刻。这就是你要构建的布局。
  2. 为该帧编写静态 CSS。.scene-content 容器必须使用 width: 100%; height: 100%; padding: Npx; 配合 display: flex; flex-direction: column; gap: Npx; box-sizing: border-box 来填充整个场景。使用内边距将内容向内推——永远不要 在内容容器上使用 position: absolute; top: Npx。绝对定位的内容容器在内容高于剩余空间时会溢出。保留 position: absolute 仅用于装饰元素。
  3. 使用 gsap.from() 添加入场动画——从屏幕外/不可见动画到 CSS 位置。CSS 位置是事实来源;补间描述了到达那里的旅程。
  4. 使用 gsap.to() 添加退场动画——从 CSS 位置动画到屏幕外/不可见。

示例

/* scene-content 填充场景,内边距定位内容 */
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px;
  gap: 24px;
  box-sizing: border-box;
}
.title {
  font-size: 120px;
}
.subtitle {
  font-size: 42px;
}
/* 容器填充任何场景大小(1920x1080、1080x1920 等)。
   内边距定位内容。Flex + gap 处理间距。 */

错误——硬编码尺寸和绝对定位:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// 步骤 3:动画进入这些位置
tl.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
tl.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
tl.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);

// 步骤 4:从这些位置动画退出
tl.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
tl.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
tl.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);

当元素跨时间共享空间时

如果元素 A 在元素 B 进入同一区域之前退出,那么两者都应该为它们各自的主角帧设置了正确的 CSS 位置。时间线排序保证了它们永远不会在视觉上共存——但是如果你跳过了布局步骤,你将无法捕捉到由于时间错误而导致它们意外重叠的情况。

什么算作有意重叠

分层效果(文字背后的发光、阴影元素、背景图案)和 z 轴堆叠设计(卡片堆叠、深度层次)是有意的。布局步骤旨在捕捉无意的重叠——两个标题相互叠加、一个统计数据覆盖标签、内容溢出画面。

数据属性

所有片段

属性必需值
id是唯一标识符
data-start是秒数或片段 ID 引用("el-1"、"intro + 2")
data-duration对于 img/div/合成是必需的秒数。视频/音频默认为媒体时长。
data-track-index是整数。同一轨道的片段不能重叠。
data-media-start否从源文件开始的裁剪偏移(秒)
data-volume否0-1(默认 1)

data-track-index 不影响视觉分层——请使用 CSS z-index。

合成片段

属性必需值
data-composition-id是唯一的合成 ID
data-start是开始时间(根合成:使用 "0")
data-duration是优先级高于 GSAP 时间线时长
data-width / data-height是像素尺寸(1920x1080 或 1080x1920)
data-composition-src否外部 HTML 文件的路径

合成结构

通过 data-composition-src 加载的子合成使用 <template> 包装器。独立合成(主 index.html)不使用 <template>——它们直接将 data-composition-id 的 div 放在 <body> 中。在独立文件中使用 <template> 会隐藏浏览器中的所有内容并破坏渲染。

子合成结构:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- 内容 -->
    <style>
      [data-composition-id="my-comp"] {
        /* 作用域样式 */
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
    <script>
      window.__timelines = window.__timelines || {};
      const tl = gsap.timeline({ paused: true });
      // 补间...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

在根文件中加载:<div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="10" data-track-index="1"></div>

视频和音频

视频必须带有 muted playsinline 属性。音频始终是一个单独的 <audio> 元素:

<video
  id="el-v"
  data-start="0"
  data-duration="30"
  data-track-index="0"
  src="video.mp4"
  muted
  playsinline
></video>
<audio
  id="el-a"
  data-start="0"
  data-duration="30"
  data-track-index="2"
  src="video.mp4"
  data-volume="1"
></audio>

时间线契约

  • 所有时间线都以 { paused: true } 开始——播放器控制回放
  • 注册每个时间线:window.__timelines["<composition-id>"] = tl
  • 框架自动嵌套子时间线——不要手动添加
  • 时长来自 data-duration,而不是来自 GSAP 时间线长度
  • 永远不要为了设置时长而创建空的补间

规则(无商量余地)

确定性: 不允许使用 Math.random()、Date.now() 或基于时间的逻辑。如果需要伪随机值,请使用种子化的 PRNG(例如 mulberry32)。

GSAP: 仅动画化视觉属性(opacity、x、y、scale、rotation、color、backgroundColor、borderRadius、变换)。不要动画化 visibility、display,或调用 video.play()/audio.play()。

动画冲突: 永远不要同时从多个时间线动画化同一元素的相同属性。

无 repeat: -1: 无限重复的时间线会破坏捕获引擎。根据合成时长计算确切的重复次数:repeat: Math.ceil(duration / cycleDuration) - 1。

同步时间线构建: 永远不要在 async/await、setTimeout 或 Promise 内部构建时间线。捕获引擎在页面加载后同步读取 window.__timelines。字体由编译器嵌入,因此它们立即可用——无需等待字体加载。

绝对禁止:

  1. 忘记 window.__timelines 注册
  2. 使用视频的音频——始终是静音视频 + 单独的 <audio>
  3. 将视频嵌套在定时 div 内——使用非定时包装器
  4. 使用 data-layer(使用 data-track-index)或 data-end(使用 data-duration)
  5. 动画化视频元素的尺寸——动画化一个包装器 div
  6. 调用媒体元素的 play/pause/seek——框架拥有回放控制权
  7. 创建没有 data-composition-id 的顶级容器
  8. 在任何时间线或补间上使用 repeat: -1——始终使用有限重复
  9. 异步构建时间线(在 async、setTimeout、Promise 内部)
  10. 在后面的场景中在片段元素上使用 gsap.set()——它们在页面加载时不存在于 DOM 中。请改用时间线内部在或之后该片段的 data-start 时间处的 tl.set(selector, vars, timePosition)。
  11. 在内容文本中使用 <br>——强制换行不考虑实际渲染的字体宽度。自然换行的文本加上一个 <br> 会产生一个额外的、不需要的换行,导致重叠。请改用 max-width 让文本自动换行。例外:简短的显示标题,其中每个单词故意独占一行(例如,130px 的“THE\nIMMORTAL\nGAME”)。

场景过渡(无商量余地)

每个多场景合成必须遵循所有这些规则。违反其中任何一条都会导致合成失效。

  1. 始终在场景之间使用过渡。不允许跳切。没有例外。
  2. 始终在每个场景上使用入场动画。每个元素都通过 gsap.from() 动画进入。没有元素可以完全成形地出现。如果一个场景有 5 个元素,它就需要 5 个入场补间。
  3. 永远不要使用退场动画,除了在最后一个场景。这意味着:在过渡触发之前,不允许有 gsap.to() 将不透明度动画化为 0、y 移出屏幕、缩放为 0 或任何其他“退出”动画。过渡本身就是退场。在过渡开始时,传出的场景内容必须完全可见。
  4. 仅限最后一个场景: 最后一个场景可以使元素淡出(例如,淡出为黑色)。这是唯一一个允许使用 gsap.to(..., { opacity: 0 }) 的场景。

错误——在过渡前使用退场动画:

// 禁止——这会在过渡能够使用场景之前清空场景
tl.to("#s1-title", { opacity: 0, y: -40, duration: 0.4 }, 6.5);
tl.to("#s1-subtitle", { opacity: 0, duration: 0.3 }, 6.7);
// 过渡在空帧上触发

正确——仅入场,过渡处理退场:

// 场景 1 入场动画
tl.from("#s1-title", { y: 50, opacity: 0, duration: 0.7, ease: "power3.out" }, 0.3);
tl.from("#s1-subtitle", { y: 30, opacity: 0, duration: 0.5, ease: "power2.out" }, 0.6);
// 无退场补间——7.2 秒处的过渡处理场景切换
// 场景 2 入场动画
tl.from("#s2-heading", { x: -40, opacity: 0, duration: 0.6, ease: "expo.out" }, 8.0);

动画护栏

  • 第一个动画偏移 0.1-0.3 秒(而不是 t=0)
  • 在入场补间中变化缓动函数——每个场景至少使用 3 种不同的缓动函数
  • 不要在场景内重复入场模式
  • 避免在深色背景上使用全屏线性渐变(H.264 条带现象——使用径向或纯色 + 局部发光)
  • 渲染视频使用 60px+ 的标题、20px+ 的正文、16px+ 的数据标签
  • 在数字列上使用 font-variant-numeric: tabular-nums

当没有提供 visual-style.md 或动画指导时,请遵循 house-style.md 中的美学默认值。

排版和资源

  • 字体: 只需在 CSS 中写下你想要的 font-family——编译器会自动嵌入受支持的字体。如果某个字体不受支持,编译器会发出警告。
  • 为外部媒体添加 crossorigin="anonymous" 属性
  • 对于

…

[因翻译而截断]

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能