Communitygithub.com

shutckin/aivfx-content-kit

在 HyperFrames 引擎(将 HTML 场景渲染为视频)上制作动态图形,包含 AIVFX 工作室层:可创建姓名条、章节卡片、数字、Shorts 和 Reels 钩子、片尾卡和标题。品牌样式(颜色、字体、动画、时长)集中在一个文件中,视频通过角色简档描述场景,动画用文字设定,并支持在素材上进行草稿渲染以及带透明通道的最终 ProRes 4444 输出。提供时序规则、9:16 和 16:9 安全区域检查、代码检查、黑帧检测、交付清单和品牌文件校验器。触发词:'lower third', 'motion graphics', 'chapter card', 'shorts hook', 'end card', 'transparent overlay', 'brand kit for motion', 'HyperFrames'。俄语触发词:'сделай плашку', 'нижняя треть', 'плашка с именем', 'заставка', 'глава', 'титры', 'хук для шортс', 'финальная карточка', 'моушен для ролика', 'графика с альфой для монтажа', 'заведи бренд для графики', 'сделай на хайперфреймс'。

aivfx-content-kit 是什么?

该技能基于 HyperFrames 引擎为 AI 智能体(如 Claude Code)提供专业的动态图形制作能力。HyperFrames 是一个开源引擎(由 HeyGen 开发),可将 HTML/CSS/GSAP 时间线场景渲染为视频,支持 MP4、WebM 和带透明通道的 MOV ProRes 4444 格式。技能通过三个核心文件管理整个工作流:`brand.json` 集中定义品牌样式(颜色、字体、动画时长、间距等),`scenes.json` 按角色(钩子、姓名条、章节、数字、片尾卡等)描述场景简档,而每个角色对应一个 HyperFrames 模板。这套机制确保了同一品牌下的所有图形都遵循统一的视觉语言,即使由不同智能体在不同时间创作。工作流程包括编写场景计划、生成草稿预览(叠加在素材上)、执行代码检查(`hyperframes lint`/`check`)、检测黑帧和对比度问题,最后输出带透明通道的 ProRes 4444 文件供后期剪辑软件(如 DaVinci Resolve、Premiere Pro)使用。技能还内置了安全检查区域(适配 9:16 和 16:9 比例)、品牌文件校验脚本 `check_brand.py`,以及针对横向模式和竖屏模式的交付检查清单。适用于需要保持高度一致性的视频系列,例如专家访谈、教程、Shorts 和 Reels 内容等。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shutckin/aivfx-content-kit/tree/HEAD/skills/motion-graphics

在你喜欢的 AI 中提问

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

文档

动画图形制作套件

说明使用俄语。请以用户所使用的语言回复。

为何需要

那些“凭感觉”逐一制作的图形卡片,到了第三张就开始分裂:一个从底部进入用时半秒,另一个从侧面进入用时一秒,字体大两号,强调色又是另一个色调。观众不会对此进行表述,但视频看起来就像是用别人的片段拼凑而成。

动效工作室基于 HyperFrames 构建,并将其打造成了自己的工厂:品牌决策仅做一次并记录在文件中,视频通过角色简档来描述场景,智能体将简档转化为合成并渲染。新的图形卡片会与之前的一致,即使一个月后由另一个智能体制作也是如此。

工作原理

工具作用输入输出
HyperFrames引擎:场景即 HTML 合成,渲染为视频,自带校验HTML、CSS 和 GSAP 时间线 → MP4、WebM 或带透明通道的 MOV ProRes 4444
Claude Code(或类似工具)智能体根据简档组装场景简档 + 品牌文件 → 合成、渲染、校验
品牌文件集中管理颜色、字体、动画、间距brand.json → 每个场景的参数
ffmpeg在素材上生成草稿、帧列表、黑帧检测带透明通道的场景 + 视频帧 → 预览和帧列表
ProRes 4444输出带透明背景的最终文件供剪辑使用包含透明通道的 MOV 文件
DaVinci Resolve(或同类:Premiere、Final Cut)剪辑,将图形叠加在视频上MOV ProRes 放置在素材上方轨道

智能体编写方案、简档、合成并运行校验;由所有者批准方案和草稿;文字(姓名、数字)由所有者或客户提供。

HyperFrames 是 HeyGen 的一个开源引擎:https://hyperframes.heygen.com。其中的合成是一个包含 data-* 时间属性、GSAP 时间线用于动画以及 CSS 用于样式的 HTML 文件。需要 Node.js 22 或更高版本以及 ffmpeg。

HyperFrames 自带功能工作室新增功能
包含轨道和场景时机的 HTML 合成品牌文件:颜色、字体、动画、间距;每次渲染前打印品牌规则
hyperframes init,在浏览器中预览工作室按场景角色编写的视频简档,替代手动布局每个合成
hyperframes render:MP4、WebM 和带透明通道的 MOV ProRes 4444(--format mov),--quality draft角色和模板库:角色转换为特定品牌的模板,同一简档可用于任何品牌风格
hyperframes lint、check 和 validate:标记和时机错误、浏览器错误、缺失文件、文本对比度在真实素材上的草稿预览和联系帧表,替代在黑色背景上评估
hyperframes add:从注册库中添加预制模块和效果将最终版本与草稿对比检测暗帧和黑帧查找
hyperframes doctor:检查运行环境check_brand.py:在第一个场景之前检查品牌文件
--docker 确保不同机器上结果一致内嵌在合成中的本地字体和本地 GSAP,按场景命名文件

以下原则也适用于其他将代码转化为视频的引擎。

何时启用

视频中的图形(演讲者姓名、章节、数字、片尾卡)、Shorts 和 Reels 的钩子、用于剪辑的透明叠加层、新的动效品牌。

不要启用全屏推广视频(10-25 秒,带有自己的情节):这类视频需要根据音乐节奏进行分镜,每个视频有自己的合成,场景角色反而碍事。视频分镜由 shot-list 处理,文章封面由 article-cover 处理,生成式画面风格由 film-look 处理。

三个文件代替一个大文件

  1. 品牌文件 brand.json:颜色、字体、文本大小、动画词汇、角色时长、间距和安全区域。每个品牌一份,很少修改。包含虚构品牌和每个字段注释的示例:templates/brand.example.json。
  2. 视频简档 scenes.json:按角色排列的场景列表。仅包含含义和文本,不含任何颜色或动效参数。示例:templates/scenes.example.json。
  3. 角色模板:每个角色对应一个 HyperFrames 合成,它读取品牌和场景参数并代入数值。需要自己编写模板,每个角色工作量不大。良好起点:hyperframes init 和通过 hyperframes add 从注册库添加预制模块。

核心规则:某个场景需要的颜色、字体或速度,但未在品牌文件中记录,这是一个信号。要么将其加入品牌文件供所有场景使用,要么放弃。那种“仅在此处”的微调正是导致系统崩溃的原因。如果需要新样式:创建新模板,而不是修改通用模板以适应某个项目。

如何创建品牌文件

  1. 将 templates/brand.example.json 复制到项目中作为 brand.json。
  2. 从网站或品牌指南中获取颜色。没有指南:询问所有者关于背景色、主文本色和强调色。不要为客户编造品牌颜色。
  3. 每种颜色赋予一个含义:背景、文本、第二行、强调色。如果无法说明颜色用途,则说明它是多余的。五种活跃颜色是上限。
  4. 字体:一个用于标题和数字,一个用于说明文字,也可以统一用一种。仅使用无衬线或衬线字体。任何地方都不使用等宽和像素字体,包括数字、日期和标签。数字使用宽度相等的无衬线字体:在 CSS 中使用 font-variant-numeric: tabular-nums。计数器不再跳动,字体保持生动。
  5. 将字体嵌入合成中(通过项目文件或直接在 CSS 中)。来自互联网的字体可能在渲染时无法加载,导致帧使用系统字体。GSAP 也应本地存放,网络加载可能在渲染过程中失败。
  6. 在 rules 中用文字记录品牌限制:如何使用强调色,是否可以引入新颜色,从哪里获取事实。智能体在每次构建前读取这些规则,否则它们会在会话之间丢失。
  7. 运行校验:
python3 scripts/check_brand.py brand.json

脚本查找必填字段、非十六进制颜色、文本与背景对比度低于 4.5:1、等宽和像素字体、在 1080 帧上小于 28 像素的文本、超出合理范围的时长以及未能覆盖平台界面的安全区域。出现违规时退出代码为 1。

场景角色

描述角色,而不是模板。角色说明场景的用途,而模板则根据品牌选择。更换品牌后,同一角色将以不同风格组装,无需重写简档。

角色用途字段背景时长
hookShots 前 1-3 秒,吸引手指停留title(3-6 个单词),subtitle 可选自有,全帧2-3 秒
name画面中谁在说话title(姓名),subtitle(身份)透明3-5 秒
chapter意思模块切换label(编号),title自有或透明2.5-4 秒
number需要记住的一个数字value,unit,note透明3-4 秒
endcard结尾:姓名、网站、后续行动title,meta,Logo自有,全帧4-6 秒

简短事实、角落笔记或带有分隔符的枚举也可以是角色(fact,note,list)。当同一任务第二次出现时,才创建新角色,而不是为单个场景创建。

画面中的位置 at:bl,br,tl,tr,left,right,center。姓名条几乎总是在左下角,位于演讲者视线相反的一侧。

文本仅来自简档。不要虚构姓名、职位、数字和地址:没有数据就问。图形卡片上的姓氏错误每位观众都能看到。

用文字描述动画

在场景中,动画应像导演那样描述,而不是程序员:

强调线从左向右划线,名字在其后升起,职位随后显现;保持住;所有内容向下一个动作消失

智能体将其转换为品牌参数和 GSAP tween:“升起”表示在 motion.travel_px 距离内,以 motion.enter_sec 时长和 ease_enter 缓动,“随后”表示延迟 stagger_sec 秒,“消失”表示 exit_sec 秒。如果描述中没有所需词汇,则使用品牌默认值,而不是自行编造速度。

  • 一个场景一个意思。 如果场景表达两个意思,则分为两个场景。
  • 先有最终帧,再运动。 在场景中所有内容都到位后先布局,然后再添加入场和出场。这样重叠部分在渲染前可见。
  • 入场慢于出场。 出现时伴有减速,消失时加速且速度大约快一倍。观众关注入场,出场对他们来说不重要。
  • 整个视频一个方向。 从底部进入,则从底部或沿同一轴线消失。方向混乱看起来像剪辑错误。
  • 一个场景不超过两种技巧。 平移和显现就足够了。同时使用旋转、弹跳和模糊看起来像是引擎演示。
  • 短距离,元素依次出现。 平移 30-60 像素看起来高档,跨半个屏幕则廉价。先线,再名字,再说明文字。
  • 钩子按单词显示,不是按字母。 逐字母显示缓慢且干扰阅读。
  • 最终画面保持不动 3-4 秒,否则观众来不及阅读。
  • 代码中避免随机性。 随机数和当前时间会导致每次渲染产生不同画面。使用基于元素索引的公式来产生变化。

手机上的时机和可读性

  • 文本完全出现后,保持静止时间不少于 min_hold_sec。
  • 阅读时间:每个单词约 0.3 秒加上入场时间。六个单词的图形卡片时长不少于 3 秒。
  • 使用中等大小文本。全屏巨大标题显得像在吼叫。
  • 短边 1080 像素:标题 64-110,说明文字不少于 40,标签不少于 28。更小的字在手机上无法阅读。
  • 一行不超过 25-30 个字符。长行按意思分行,不是按宽度。
  • 放在素材上方的文本必须带有背景板、阴影或暗化效果。对比度 4.5:1 是针对背景板计算的,而不是空白背景。
  • 只强调一个词或一条线。整段用强调色填充无法阅读。
  • 场景的时间线必须填满其插槽:在末尾添加一个覆盖整个场景时长的空 tween。否则 HyperFrames 会提前隐藏场景,导致视频中出现黑帧。

安全区域

平台会用自己的界面覆盖部分画面。以下是针对短边为 1080 的帧的数值,请在平台的最新截图上复核。

9:16(1080x1920,Shorts、Reels、TikTok): 顶部约 250 像素(昵称、按钮),底部约 400(说明文字、音乐、进度条),右侧约 140(点赞和评论),左侧约 60。钩子和重要文本放在中央区域。竖屏中的姓名条应比常规位置更高。

16:9(1920x1080,YouTube,横屏剪辑): 两侧约 96 像素,顶部 54 像素,底部约 96 像素。在最后 5-20 秒 YouTube 会放置片尾卡片,片尾卡的构建要为其留出位置。

安全区域保存在品牌文件中,通过将边框覆盖在草稿帧上来检查场景。

渲染

  • 草稿: hyperframes render --quality draft,比最终版本快数倍。用其检查所有内容,最终版本只渲染一次。
  • 常规视频(MP4,H.264): 用于钩子、片尾卡以及所有全屏内容。Alpha 通道只会增大文件体积。
  • 用于剪辑的透明背景: 图形卡片、叠加在素材上的章节、数字。HyperFrames 自行渲染带透明通道的 MOV ProRes 4444(--format mov),适用于 DaVinci Resolve、Premiere 和 Final Cut;网页使用带透明通道的 WebM(--format webm)。MP4 不支持透明通道。全屏剪辑用图形可通过 ffmpeg 转换为更轻量的 ProRes 422 HQ。
  • 防止渐变中出现条纹:添加轻微噪点(texture.grain)并使用 ProRes 母版。
  • 不要启用 PNG 帧捕获(--video-frame-format png):在工作室的校验中它会导致暗部区域变黑。
  • 文件名按场景使用拉丁字母:name-01-sokolova.mov。

最终版前在素材上创建草稿

在黑色背景上一切看起来都正常。问题只有在真实画面上才能发现:图形卡片遮挡了人脸,白色文字消失在了窗户中。

  1. 以草稿质量渲染带透明背景的场景。
  2. ffmpeg 将它们叠加到真实视频的帧或片段上(简档中的 preview_bg:文件、视频或帧文件夹,循环分配给场景)并合并为一个预览视频。
  3. 帧列表:每个场景的开始、中间和结束画面合并为一张图片。
  4. 目视检查并展示给所有者,附带编号的场景列表,以便其用一个词回答。通过 lint 并不代表设计有效。

校验

  • hyperframes lint:在每个新模板之后、展示之前运行。 hyperframes check(lint、浏览器错误、布局和文本对比度一次性运行),hyperframes doctor:如果渲染失败则运行。Lint 能捕获真实错误:全屏图层在开始时没有零透明度会导致前几帧曝光过度;与 y 轴 tween 结合使用的 translate(-50%,-50%) 居中方式会在动画结束时偏移,请使用 flex 包裹器居中。
  • 在草稿和最终版本中查找黑帧:ffmpeg 捕捉帧亮度,连接处的全黑帧表示场景丢失或视频卡死。合成内的每个视频必须有各自的 id,否则帧会卡住。
  • 将最终版本与草稿对比暗帧:掉入黑色的像素比例不应增加。

工作流程

  1. 品牌:是否有 brand.json?如果没有,创建并使用脚本校验。
  2. 方案:包含角色、文本、格式和时长的编号场景列表。展示方案,而不是视频:
品牌:Fjord Lab,16:9,图形卡片使用透明通道

01. name / bl / 透明: '玛丽亚·索科洛娃' · '音响工程师',4秒
02. chapter / 透明: '第2章' · '我们如何录制静默',3秒
03. number / right / 透明: 48小时 · '录制一集的时间',3.5秒
04. endcard / MP4: 'Fjord Lab' · fjordlab.example,5秒
  1. 根据已批准方案创建简档 scenes.json。
  2. 按角色创建合成,运行 hyperframes lint。
  3. 在素材上创建草稿、帧列表、查找黑帧、展示。
  4. 用文字进行修改(“第三个短一点”、“名字大一点”)在简档中修改;通用修改(“所有图形卡片更慢”)在品牌文件中修改。
  5. 最终渲染,透明场景使用 ProRes 4444,与草稿对比,将文件输出到剪辑文件夹。

常见错误

  • 直接在场景中设置颜色或速度。 五个视频项目后会有五种不同的强调色。所有视觉元素仅在品牌文件中。
  • 在纯色背景上评估图形。 图形卡片在应用到项目素材之前看起来“很棒”……

...(对于此技能,SKILL.md 已截断,实际版本包含更多内容,例如典型错误、交付检查清单等)

Individual skills in this repo

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

shutckin/aivfx-content-kit

Runs a client AI video for a concept studio from brief to delivery. Takes the brief and real product photos, writes a synopsis, builds character and location sheets with 3 options each, a 16:9 approval deck, stills in waves, one prompt for the whole video, client revisions as a list, assembly and a delivery checklist. Core rule: the client approves the preproduction package before the first video frame, and the approved character and location sheets go as references into every generation. Use when a brief arrives for an advertising or product AI video. Triggers: 'client AI video', 'preproduction package', 'character sheet', 'location sheet'. Not for articles or covers (use blog-article and article-cover). Triggers (RU): «вот бриф», «новый клиент», «концепт студия», «препродакшн-пакет», «лист персонажа», «лист локации», «презентация клиенту», «правки от клиента», «готовим сдачу».

shutckin/aivfx-content-kit

Packages YouTube videos and Shorts: a pack of 3-4 thumbnail variants of one idea for choice and A/B testing, title and thumbnail as one unit, one idea per image, face and emotion, a large object, text up to 3-4 words or none, readable on a small phone screen. Works from own frames and screenshots plus references, generates or refines the frame with models (Nano Banana, Seedream, GPT-Image, Higgsfield and others) with the film-look style and logos in one pass, keeps a consistent channel series, checks the file with a script (size, weight, name), reviews the small view by eye on a contact sheet and shows options to the owner before upload. Triggers: 'YouTube thumbnail', 'video packaging', 'thumbnail A/B test', 'Shorts cover', 'title and thumbnail'. Triggers (RU): «сделай превью», «обложку для ролика», «обложку для YouTube», «упакуй ролик», «варианты для A/B-теста», «заголовок и превью», «обложку для Shorts», «серия превью для канала».

相关技能