vox-explainer 是一个用于制作 Vox 风格纪录片式解说短片的技能，在 Claude Code 中以代码方式完成整支影片。成片为 30-60 秒，最终产物是一个自包含的 HTML 文件，再导出为 MP4。每一帧都由代码生成，不使用视频生成器，也不使用素材库。
用途 它面向需要短小、有编辑感的“为什么”类解说视频的场景：用一个陌生人能半懂的问题切入，用带来源的事实回答，并以五词以内的结论收尾。
主要能力
- 视觉风格：编辑式纪录片解说风格，撕纸卡片配小投影，半调网点、纸张颗粒与细胶片颗粒覆盖全画面，仅在画面边缘做色差，柔和暗角，粗体窄体无衬线字以完整块面呈现。
- 动画：阶梯式动画，按二拍（on twos，24fps 下每个绘制姿势保持 2 帧）推进，不使用平滑的企业式缓动，不使用打字机效果，文字不加渐变、发光或弹跳。
- 镜头类型：动能陈述（撕纸条上的三行粗体窄体字）、纸卡片（撕边卡片带小阴影落入，用于同时展示多个事物）、前后对比（同一卡片、日期标签翻转）、标注圈选（标记圈自绘后出现标签）、计数器（代码生成、不靠猜测的数字）、网格（大量相同瓷砖后一个打破规律）。
- 声音：声音不是可选项，需用代码写配乐——低音铺底、每个新镜头一次击打、最后一句上扬；旁白（自己的或文本转语音）置于最上层。
- 事实约束：屏幕上每个名字、日期和数字都必须与给定事实清单逐字一致，不添加未提供的内容；每条口播事实在进入脚本前都要在事实文件中标注来源；研究只显示相似性时用“looks like”，不用“is”。
使用方式
- 开始前：若存在 brand.md 和 MOTION.md 需先阅读；若不存在，先运行 brand-intake，或询问十六进制色值、字体和标志文件。没有这些就不能称结果符合品牌。
- 先问四件事并等待：问题（一个陌生人能半懂的“为什么”问题）；事实（回答该问题的名字、日期和数字，每条附来源链接，若用户没有则先研究并展示带来源的清单）；颜色（三个十六进制色值加一个强调色，默认调色板为红 #B8312A、奶油 #F1E6D0、纸白 #FBF7EE、藏青 #14213D、黄色强调 #F2C230，默认需标注为默认）；尺寸（1920 x 1080 用于 YouTube，1080 x 1350 用于 LinkedIn 信息流，1080 x 1920 用于 Story 或 Reel）。屏幕上每个事实都有来源之前不要开始构建。
- 写脚本，每个镜头一行：8-14 个镜头，每句一句，镜头 1 就是问题本身；每个镜头回答上一句提出的内容，说不清某个镜头证明了什么就删掉；最后一个镜头是结论，五词以内。脚本以编号列表展示并等待确认。
- 为每行选择镜头类型（见上文镜头类型）。
- 构建：将构建简报粘贴进 Claude Code，附上脚本和镜头清单。要求生成一个名为 index.html 的自包含文件，除附件外不加载外部字体、图片或库，不从互联网加载任何内容；严格使用指定调色板；按镜头清单控制时长，每个镜头保持到能朗读完；所有帧仅由时间推导，添加 window.seek(seconds) 绘制该精确时刻；最后一帧可以与第一帧不同（这是影片，不是循环）。构建后从每个镜头中段截取一帧，检查文字截断、卡片重叠、名字拼写错误以及任何不在事实清单中的日期，修正真实存在的问题并保留第一版。
- 像剪辑师一样检查：导出前逐帧确认每个日期和名字与事实清单逐字符一致；没有卡片遮住另一张卡片的文字；不该平滑的地方没有平滑；前 3 秒已展示问题（人们在 3 秒内做决定）。
- 导出：最简便的路径是 HyperFrames，来自 HeyGen 的免费开源工具（npx skills add heygen-com/hyperframes，然后 npx hyperframes render）。任何能逐步调用 window.seek 并把帧保存为 MP4 的工具也可以。安装任何东西前先确认工具是否存在，并先询问。
适用场景 适合制作 30-60 秒的纪录片式解说短片，用于 YouTube、LinkedIn 信息流、Story 或 Reel 等画幅；适合需要编辑感、撕纸与半调质感、阶梯式动画风格的内容；适合以“为什么”问题驱动、以带来源事实支撑的解说。
限制 该技能不会编造事实、日期或引语；不会凭记忆复刻真实品牌标志，只能使用用户文件或按品牌名排版的纯文字；不会声称某个趋势由单一原因造成，只说“one reason”，不说“the reason”。此外，若缺少品牌信息（brand.md、MOTION.md 或色值、字体、标志文件），不能称结果符合品牌。