Communitygithub.com

nateherkai/hyperframes-student-kit

规划、编写、计时、样式化并验证长篇谈话类HyperFrames视频的动态图形节拍。当Codex被要求添加或改进视觉节拍、毛玻璃下三分、皱纸全屏接管、与文本同步的标注、节奏覆盖、YouTube留存率图形或可渲染叠加层到现有HyperFrames视频项目时使用。

hyperframes-student-kit 是什么?

该技能用于为长篇谈话类视频(HyperFrames项目)设计和实现动态图形节拍,以提升观众参与度和信息保留率。其核心目标不是随意添加图形,而是为叙述中的关键概念、数据、过渡或心理模型提供视觉支持。技能覆盖了从首次项目检查、文本分析、节拍策略选择(皱纸全屏 vs. 毛玻璃下三等)到具体计时、文案撰写、视觉风格遵循和最终验证(包括运行HyperFrames linter)的完整工作流程。它特别强调基于叙述主题进行智能编排,而非简单按固定时间间隔填充,以避免打断讲话者或使观众疲劳。该技能适用于任何使用HyperFrames框架的谈话类视频项目,尤其注重与现有设计系统、CSS样式和项目特定指令(如AGENTS.md)的整合。通过提供明确的实用默认值(如节拍时长、扫描间隔)和优先保留用户品味决策的原则,它帮助AI Agent(如Codex)高效、一致地生成专业且引人入胜的视频图形。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/hyperframes-video-beats

在你喜欢的 AI 中提问

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

文档

HyperFrames 视频节拍

使用此技能将谈话类视频及其文稿转化为一组有节奏的动态图形,以支持旁白,同时避免不必要地遮挡讲话者。

核心目标

保持观众的定向感和参与度。每个节拍必须回答以下问题之一:

  • 观众应该记住什么?
  • 哪个概念需要视觉结构?
  • 什么数据、对比或转折点值得强调?
  • 哪里节奏变慢以至于观众可能分心?

不要仅仅因为存在空白时间而添加图形。只有当旁白包含一个需要视觉支持的主题、过渡、论证点或心智模型时,才添加图形。

首次扫描

  1. 阅读项目说明(AGENTS.md、本地技能文档和项目特定说明)。
  2. 检查根合成、当前节拍计划表、共享CSS和文稿。
  3. 根据根目录的 data-start / data-duration 条目或主 SHOW 数组构建覆盖图。
  4. 提取任何请求区域以及任何未覆盖间隙的文稿块。
  5. 根据旁白而非任意时间戳识别主题跨度。
  6. 根据每个主题决定是否需要全屏纸张节拍、毛玻璃下三分之一卡片,或无需新节拍。

使用快速的本地命令。优先使用 rg、Select-String 以及小型 Node/PowerShell 文稿脚本。

节拍类型决策

使用全屏皱纸

当旁白达到一个主要的论点、列表、章节标记、引语或数据点时,使用纸效果全屏接管,使该内容短暂地成为整个画面。

适用场景:

  • 钩子兑现或“本视频内容”概述
  • 主要章节过渡
  • 重要数据或研究结果
  • 令人难忘的论点句
  • 简短引语或箴言
  • 需要观众停下来仔细思考的对比

规则:

  • 保持简短,通常4-12秒。
  • 使用稀疏的黑色文本。
  • 只允许真正的数字或一个极其重要的词使用强调色。
  • 不要用纸效果全屏覆盖长篇解释。
  • 默认情况下,不要使全屏文字变得花哨、过大或过粗。

使用毛玻璃下三分之一

当讲话者需要保持可见,并且图形应支持当前想法时,使用毛玻璃下三分之一卡片。

适用场景:

  • 解释骨架
  • 主题标签
  • 公式风格的心智模型
  • 小列表
  • “这意味着什么”的解读
  • 长时间谈话段落的节奏填充
  • 缩短的全屏或分屏节拍之后的跟进卡片

规则:

  • 将下三分之一保持在画面下部三分之一或下半部分。
  • 避免遮挡脸部。
  • 使用简洁文本:一个标题加可选短副标题,或一个2-4项的列表。
  • 每个主题跨度优先使用一个卡片,而非许多短暂的闪光。
  • 保留现有的玻璃卡片样式,除非用户要求更改设计。

节奏启发式方法

对于长篇YouTube谈话类视频:

  • 视频早期:避免超过20-30秒无视觉节拍。
  • 主体部分:避免超过30-45秒无节拍。
  • 密集解释段落:大致在每个主题跨度使用下三分之一,而非每个句子。
  • 大型纸效果全屏应作为偶尔的标点符号,而非默认选项。
  • 如果现有节拍因感觉太长而被手动缩短,请尊重该选择,并在其后填充一个新的较短卡片。

在扫描计划时,根据可见性调度报告真实间隙,而不仅仅是DOM顺序。如果根时间轴使用 SHOW 数组,那通常是权威的可见范围。

计时方法

每个节拍的计时必须与文稿主题相匹配:

  1. 找到主题开始的第一个词或短语。
  2. 在可能的情况下,在锚点前0.2-0.6秒开始节拍。
  3. 保持节拍可见,直到主题结束或自然交接。
  4. 如果下一个节拍立即开始,在它之前预留0.1-0.5秒的清除时间,除非故意安排交接。
  5. 匹配子元素的入场时间与口语短语。

避免此故障模式:

  • 卡片在正确的主题上出现,但只持续5-8秒,而讲话者继续讨论该主题20-40秒。

偏好:

  • 一个卡片跨越整个主题,如果叙述在中间发展,则在过程中添加一个副标题或列表项。

内容撰写

为扫读理解而撰写。观众应在一秒内理解卡片内容。

使用:

  • 简短的名词短语
  • 直接标签
  • 每个卡片一个心智模型
  • 仅在数字有意义时使用
  • 在需要澄清动作时使用动词

避免:

  • 重复整个旁白
  • 长句
  • 模糊的夸张语言
  • 过多高亮词语
  • 在图形内解释如何使用视频

良好模式:

瓶颈
没有足够的人工智能融入实际工作流程。
问题是采用,而非原始人才。
桥梁
技能 + 工作流程 = 节省40小时
本视频内容
-> 研究
-> 数据
-> 你可以选择的路径
-> 真正重要的东西

视觉样式规则

首先遵循本地设计系统。对于此项目系列,使用:

  • 严肃专业的排版。
  • 在纸效果节拍上使用黑色主要文本。
  • 仅对主要数据数字或罕见的重点词使用强调蓝色。
  • 使用现有深色磨砂风格的玻璃卡片。
  • 下三分之一卡片不遮挡讲话者脸部。

对于纸效果节拍:

  • 对于引导语、标签、箭头、来源、引语和支持性文本使用黑色。
  • 保持字体粗细克制。
  • 除非用户明确要求,否则避免过大、花哨的字体。
  • 使皱纸动画具有确定性。

对于玻璃卡片:

  • 重用 .glass-card dim lower-third 或最接近的现有类。
  • 优先放置在底部中央。
  • 保持卡片紧凑。
  • 当想法是结构性时,使用公式/列表辅助工具。

HyperFrames 实现规则

遵循项目 AGENTS.md 和 HyperFrames lint 规则:

  • 每个挂载的定时元素需要 data-start、data-duration 和 data-track-index。
  • 可见的定时根挂载元素应具有项目使用的预期 clip/layer 类。
  • 子合成应在 window.__timelines 上注册一个暂停的 GSAP 时间轴。
  • 使用 tl.set({}, {}, SLOT) 固定每个子合成时间轴。
  • 仅保留确定性逻辑。
  • 不要以可能导致渲染冻结的方式动画化视频元素的尺寸或媒体属性。
  • 编辑 HTML 后运行 npx hyperframes lint。

添加节拍时:

  1. 创建 compositions/beats/NNN-简短名称.html。
  2. 在 index.html 中添加根挂载。
  3. 如果存在,添加或更新主可见性调度。
  4. 使子合成的 SLOT 与挂载持续时间匹配。
  5. 验证没有同轨道重叠,除非项目有意使用多个覆盖轨道。

覆盖范围扫描

编辑后,扫描主调度:

  • 按可见开始时间排序节拍列表。
  • 打印超过目标阈值的间隙。
  • 仅在文稿具有可支持概念的地方添加或重新计时节拍。

对于此项目模式,使用30秒作为严格扫描阈值,45秒作为主体部分可接受的最大阈值。

验证

完成前:

  1. 运行 HyperFrames linter。
  2. 修复所有错误。
  3. 如果已知且非阻塞,则单独提及警告。
  4. 如果用户要求可渲染输出,则相应地进行渲染或烟雾渲染。
  5. 向用户提供确切更改的文件路径和时间戳。

实用默认值

除非项目上下文另有说明,否则使用以下默认值:

  • 全屏纸效果概述:8-10秒。
  • 全屏纸效果数据:5-8秒。
  • 毛玻璃下三分解释:12-30秒。
  • 长主题玻璃卡片:25-45秒,带交错的子元素。
  • 节拍开始前导时间:0.2-0.6秒。
  • 间隙扫描阈值:30秒。
  • 下三分之一宽度:约68-72vw,最大约1240-1280px。

保留的内容

保留在审查过程中发现的用户品味决策:

  • 如果用户说某个节拍太长,不要为了满足通用覆盖规则而恢复它。
  • 如果玻璃卡片样式已批准,则重用它,而非重新设计。
  • 如果排版已批准,则保持稳定,仅调整局部大小/粗细。
  • 如果讲话者的脸部很重要,则优先使用下三分之一卡片而非中心屏幕卡片。

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

nateherkai/hyperframes-student-kit

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

nateherkai/hyperframes-student-kit

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

相关技能