Communitygithub.com

Saucemathis/marketing-video-skill

制作任何品牌或产品的营销视频(功能发布、产品广告、社交循环),风格为精确的动态设计:一个变形的UI形状、真实光标、弹簧效果、缩放的摄像机、对齐节拍的音乐轨道,从代码渲染为MP4。

marketing-video-skill 是什么?

这是一个AI Agent技能,用于从代码生成具有精确动态设计风格的完成版营销视频。它可以为功能发布、产品广告或社交循环视频创建专业品质的输出。该技能通过一个结构化的流程工作:首先收集用户的品牌背景(主题、UI截图、设计系统和灵感视频),然后分析灵感素材以提取节奏和运动特征,接着在节拍网格上规划场景状态,最后渲染为多种格式的MP4文件。它支持在Claude Code、Cursor和Codex等平台上运行,依赖于Node.js 18+、ffmpeg和Python 3环境。所生成的视频基于单个HTML页面,其中每个像素都是时间的纯函数,通过帧渲染实现运动模糊,并精确到毫秒级的音轨同步。技能还包含强大的迭代工作流,允许用户批准每个阶段后再继续,从而在长时间渲染前节省时间。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add Saucemathis/marketing-video-skill

在你喜欢的 AI 中提问

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

文档

营销视频

该视频是一个HTML页面,其中每个像素都是时间的纯函数 seek(t),逐帧渲染带有运动模糊和精确到毫秒级的音轨。所有与品牌相关的内容均来自用户输入,不做任何假设。使用用户的母语进行沟通。以下 SKILL_DIR 指包含此文件的目录。

0. 首次运行:依赖检查

bash SKILL_DIR/scripts/check_deps.sh

该脚本会列出当前机器缺失的工具(node 18+, ffmpeg, python3, numpy),并给出对应系统的安装命令。如果缺少任何依赖,请用通俗的语言向用户说明每个工具的用途,显示安装命令,并征求用户意见是否安装。仅在用户同意后执行安装,然后重新运行检查。需要用户密码或打开自带安装程序(Homebrew、sudo)的命令,应提示用户在自有终端中运行;将命令提供给用户并等待其完成。在此期间可以同时进行用户需求收集:在步骤2之前,其他操作不依赖于工具。

1. 需求收集:首先询问所有信息

将 references/intake.md 中的问题一次性发送给用户。在构建任何内容之前,必须收集以下信息:

  • 主题:视频的内容、目标受众、发布平台;
  • 灵感视频:最重要的输入;
  • 设计系统,或明确允许使用中性默认值;
  • UI截图(当视频展示产品时)。

每个输入最终必须成为本地文件:要求用户提供下载,或当工具允许时自行获取。其他所有内容都有明确的默认值。如果某个必需项在提醒一次后仍未提供,则不启动依赖它的任何内容;对于灵感视频,可以提供引擎自身的风格(一个连续变形的形状),并在用户接受后继续。

创建项目,然后将答案记录在 brief.md 中:

bash SKILL_DIR/scripts/setup.sh ~/marketing-videos/<slug>    # 模板、脚本、本地 Playwright
cd ~/marketing-videos/<slug>                                 # 后续所有命令在此目录下运行

2. 分析灵感视频并确认理解

python3 inspect_inspiration.py <video>      # 接触表、剪辑分析、镜头时长、音乐节奏

查看两个接触表,然后写一段不超过十行的风格解读:连续变形或剪辑切换、每节拍的事件及状态保持时长、摄像机运动、缓动效果、调色板、字体、声音。展示给用户并询问保留哪些内容。用户提供的书面指导(规则、禁止项、结构)优先于你的解读。如果用户提供了音乐,立即测量其节奏(python3 inspect_inspiration.py track.mp3),并在节拍网格之前将 CONFIG.bpm 设置为该节奏。

3. 节拍网格上的状态列表,然后等待批准

一个表格,每拍一行:时间、屏幕上的状态、运动方式、光标行为、摄像机。 references/craft.md 规定了规则。在用户批准之前不要构建任何内容。 在此处迭代只需一分钟;在构建后迭代则需一小时。

4. 构建

编辑 scene.html:配置 CONFIG(节奏、节拍数、循环或结尾卡片、令牌、字体),然后替换示例场景。首先阅读 references/craft.md:它包含了引擎、运动规则和注意事项。

  • 字体:将品牌字体文件放入 fonts/ 目录(将Google字体下载为woff2格式)并在 fonts.json 中列出;CONFIG.font 首先引用其中一个字体家族。python3 build.py 会将字体内联到代码中。
  • Logo:直接粘贴品牌的SVG。切勿用字体重打字标。
  • 截图仅仅是用于简化的HTML重现的参考,绝不能作为图片粘贴。
  • 真实视频素材:使用 python3 frames.py --src clip.mp4 --name <who> --sheet 选择一个干净的窗口,然后将其裁切到帧的宽高比进行提取。素材以静音播放,除非其声音在步骤5中混入。

5. 验证,然后添加声音

python3 build.py && node preview.mjs     # 每种格式的接触表,每个节拍一帧,控制台输出和字体错误
node checks.mjs                          # 检查按钮点击是否在按钮内,指针是否在文本上

两者默认输出 1440×1440 和 1080×1920 格式;可通过 1920x1080 参数传递其他尺寸。检查每个接触表,修复所有偏离网格、拥挤、在手机尺寸下难以阅读或应在完成状态但仍在过渡中的内容。checks.mjs 必须在每种格式下通过;在 window.CHECKS 中声明每个新的点击和每个需要保护的文本。

python3 audio.py 根据场景节奏合成背景音乐,并将每个 window.CUES 声音按其测量的峰值定位。--music track.mp3 --offset <s> 使用用户的音轨;--voice clip.mp4:at:start:dur 将拍摄人物的语音混合,并降低其下的音乐音量。

6. 渲染并交付

node render.mjs scene.built.html 1440 1440 out/<slug>-v1-1x1.mp4 audio/bed.wav
node render.mjs scene.built.html 1080 1920 out/<slug>-v1-9x16.mp4 audio/bed.wav

每个交付的版本使用新的文件名,并在交付时将其源文件复制到 versions/v<N>/ 目录。切勿在渲染完成前覆盖已交付的文件。将MP4复制到用户指定的位置,并报告更改内容、通过的检查以及为用户做出的任何判断决定。

7. 迭代

遵循 craft.md#iterating 的规则:仅更改指定的部分,拉伸时间而非重新编排舞蹈,每次更改后重新运行 preview.mjs 和 checks.mjs。

要求

项目文件夹应自包含。脚本需要 node 18+、ffmpeg 和带有 numpy 的 python3(步骤0会检查并安装缺失的依赖);setup.sh 会在每个项目中添加 Playwright 的 Chromium。如果项目位于有自身规则仓库中,则遵循其规则,并将渲染结果、视频素材、帧文件和 node_modules 排除在版本控制之外。

相关技能