跳转到使用指南
faceless-explainer作者 HeyGen

Faceless Explainer Skill.

一个用于动效和视频的 Claude Code 和 Codex skill:将文本、笔记或文章转化为带有创造性场景视觉的无人解说视频。

  • Motion & Video
  • Video
heygen-com/hyperframes · skills/faceless-explainer/SKILL.mdSKILL.md
--- name: faceless-explainer description: Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes. --- ## Step 0: Setup ## Step 1: Brief (no capture) ## Step 2: Design System ## Step 3: Storyboard and Script ## Step 3.1: Audio ## Step 4: Frame Visual Design
前置数据和章节标题读取自上游文件,日期 2026-09-14 · 完整内容 29,476 字符

01 功能说明

faceless-explainer Skill 在 Claude Code 和 Codex 中的功能

摘要、工作流与产物,均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

将任意文本——一篇文章、一些笔记、一个主题、一份 brief——转化为带有虚构场景视觉效果(排版、抽象图形、图表、数据可视化)的无露脸解说视频。通过七个编排步骤运作:带 brief 确认的设置、合成采集包(无需网站)、从预置帧模板中选择设计系统并可选进行品牌 token 重混、使用叙事设计重塑输入内容的分镜与脚本、TTS 与 BGM 音频生成、添加带时间码镜头序列与虚构元素的视觉设计、通过子 Agent 并行构建帧,以及最终渲染。

协作模式下在第 0、3 和 6 步设有用户确认关卡。无露脸意味着没有采集步骤,也没有真实素材清单——所有视觉元素都由下游工作单元虚构生成。

它产出什么

  • STORYBOARD.md,包含逐帧教学计划、带时间码的镜头序列,以及自行设计的焦点/角色
  • compositions/frames/NN-*.html — 由子 Agent 构建的每帧一个 HTML 合成文件
  • renders/video.mp4 — 最终渲染的视频,横向 1920x1080、竖向 1080x1920 或方形 1080x1080
查看示例提示词 ↗

工作方式

  1. 01
    确认 Brief 并初始化项目

    BRIEF.md 存在并决定模式——阅读它,不要提问。如果缺失且项目是全新的,运行意图层来锁定 brief。

  2. 02
    创建合成采集包

    将用户的完整输入原样保存为 capture/extracted/visible-text.txt(信息来源)。

  3. 03
    选择帧预设并构建 frame.md

    从 hyperframes-creative/frame-presets/ 中挑选一个符合主题和语气的已发布预设。

  4. 04
    用叙事设计撰写 Storyboard

    使用 story-design.md 的结构,把文本转化为逐帧教学计划。

  5. 05
    生成音频并添加视觉设计

    在后台运行 audio.mjs,用于 TTS、逐词时间对齐,以及从 HeyGen 库中取用的 BGM。

  6. 06
    构建帧并组装索引

    同步时长、构建每帧数据包,并为每一帧并行派发一个子 Agent。每个 worker 写出 compositions/frames/NN-*.html。字幕在后台构建。

02 找到适合场景

何时使用 faceless-explainer Skill

当工作是此类动画和视频时,在 Claude Code 或 Codex 中使用 faceless-explainer skill。下面的适用范围和限制来自该 skill 自己的文件。

适合场景

  • 主题讲解、概念拆解、操作指南和清单式内容
  • 仅凭文本讲解一个主题,没有产品也无需网站采集
  • 当所有视觉元素都需要从零设计时:字体排印、抽象图形、图表或数据可视化

了解边界

  • 基于网站构建的视频,用于产品宣传或导览
  • 当存在采集步骤或需要真实素材清单时
  • 笼统的“做个视频”请求或任何不确定情况——必须先经过意图层

需要提供的信息

  • 任意文本来源一篇文章、笔记、一个主题,或一份 brief——完整输入原样保存为 capture/extracted/visible-text.txt。
  • 可选的用户脚本如果用户粘贴了脚本或希望保留其原话,将其原样保存为 user_script.txt。VO_MODE(逐字或重构)来自 BRIEF.md。
  • 可选的品牌色彩或字体除非用户明确提供了品牌色彩或字体,否则将 tokens.json 中的 colors 和 fonts 留空。
  • 可选语音偏好如果请求中指定了语音、性别或语气,请选择匹配的 voice id 并传入 --voice <id>。
  • 可选真实图片如果用户提供了真实图片,请将其放在 public/<basename> 下,并在 Step 3 中记录说明。

03 Skill 内部

faceless-explainer skill 赋予 Claude Code 和 Codex 的规则

SKILL.md 为 Agent 设定的 7 条具体指令、默认值与限制——正是文件中真正改变结果的部分。

  1. 处理 Brief 的起始规则

    如果 BRIEF.md 已存在,读取它即可,不要提问——brief 已经确定。

  2. 无面孔视频没有 Capture 步骤

    不要运行 npx hyperframes capture ——不存在 URL。不要创建 asset-descriptions.md 或填充 capture/assets/。无面孔视觉效果在 Step 4-5 中构思,而非采集得来。

  3. 按顺序执行各步骤,并设置检查点

    依次完成 Step 0 设置、Step 1 brief、Step 2 设计系统、Step 3 故事板、Step 3.1 音频、Step 4 视觉设计、Step 5 帧、Step 6 收尾。

  4. 默认将 asset_candidates 留空

    在无面孔视频中,帧不携带资源清单。除非用户提供了真实的 public/<basename> 图片,否则请将 asset_candidates 留空。

  5. 先检索目录,再构思视觉风格

    对于 brief 中提到的每一种指定风格、效果或转场,在写入 STORYBOARD.md 之前,先用简明英文运行 npx hyperframes catalog --query。

  6. Clip 层上的通屏背景

    帧的底色(色块、渐变、网格)本身就是一个 class="clip" 的全时长背景 clip。

  7. 时长同步是机械化操作

    真实语音时长优先;无声帧保留预估值。Step 3.1 完成后运行 audio.mjs sync-durations。切勿手动修改已同步的时长。

04 投入使用

在 Claude Code 或 Codex 中安装 faceless-explainer

一条 npx skills add 命令,然后在你的 Agent 中执行第一个任务和对结果的清单检查。

将 faceless-explainer 添加到 Claude Code、Codex 或你的 Agent

在你的项目中运行;安装程序会询问要把它添加到哪个 Agent。

Terminal
npx skills add https://github.com/heygen-com/hyperframes --skill faceless-explainer

针对 skills/faceless-explainer/SKILL.md 的通用 skills CLI 形式;具体仓库可能有自己的文档路径说明。

给 Skill 一个首次动效和视频任务

按 skill 自身的术语撰写;把括号中的部分换成你的内容。

Starter prompt
Turn this article about compound interest into a 60-second explainer video for young adults. Use clean modern graphics with invented diagrams showing how money grows over time. Keep the tone approachable and use a female voice for narration. Format: [landscape/portrait/square]. Destination: [Instagram/YouTube/LinkedIn].

来源:依据 SKILL.md,按 skill 自身的术语撰写。

检查首次结果

SKILL.md 本身如何描述正确的结果:

  • 运行 npx hyperframes lint 以验证结构
  • 运行 npx hyperframes check 以捕捉文字溢出和布局问题
  • 在各帧中点运行 npx hyperframes snapshot 生成联系表,快速浏览以发现明显的错误
  • 忽略字幕单词(#caption-word-*、.caption-line)上 1-4px 的 text_box_overflow——这是紧凑行高带来的预期误报
  • 只在 text_box_overflow 指向某个帧元素(#el-NN-*)而非字幕单词时才处理
  • 在最终渲染前运行 transitions.mjs inject and verify 以检查转场时序

在 OpenDesign 中通过其 SKILL.md 链接导入 faceless-explainer:Plugins → Add → Skill → Import from link,然后在顶部栏中选择它。

05 开源、可追溯

来源、许可与验证

本页面事实的来源,以及最后检查时间。

Author
HeyGen
Repository
github.com/heygen-com/hyperframes 分支 main
Skill 文件
skills/faceless-explainer/SKILL.md 验证时记录的内容校验和;提交 558c11b
License
Apache-2.0 来自 LICENSE。
仓库星标数
49,761 GitHub 快照摄于 2026-09-14,针对整个 heygen-com/hyperframes 仓库,该仓库在此目录中包含 9 个 skills。不是 faceless-explainer 的评分或使用计数。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

SKILL.md 内部

  1. 步骤 0:设置确认 brief、初始化项目、编写 BRIEF.md、记录偏好、显示登录状态
  2. 步骤 1:Brief(无采集)将输入保存为 visible-text.txt,创建合成的 tokens.json,不进行网站采集或素材获取
  3. 步骤 2:设计系统选择内置的 frame 预设,运行 build-frame.mjs 将品牌 token 重混到预设上
  4. 步骤 3:故事板和脚本按叙事设计编写逐帧教学方案,以提案形式呈现,循环直至获得批准
  5. 步骤 3.1:音频用 TTS 生成配音、字词时间标注,从 HeyGen 库中获取背景音乐,以及音频元数据
  6. 步骤 4:帧视觉设计添加带时间码的镜头序列、构思焦点/角色,按 Scene 内联布局与动效
  7. 步骤 5:构建帧同步时长、构建数据包、按帧派发子 Agent、汇编索引、生成字幕
  8. 步骤 6:定稿插入转场、运行 lint/check/snapshot、暂停等待审核、渲染最终 MP4
  9. 快速参考格式、faceless 方案与已采集素材工作流的差异、后台脚本、参考表
Skill 自身的描述
"将任意文本——文章、笔记、主题或 brief——转换为无人像讲解视频:没有网站或素材可捕捉,因此视觉内容按场景生成(排版、抽象图形、图表、数据可视化)。用于主题讲解、概念拆解、操作指南、列表类内容。不是从网站构建的视频(/product-launch-video——宣传或演示)。不确定时 → /hyperframes。"

来自 SKILL.md 的 front-matter 描述。完整文件约 29,476 个字符。在 GitHub 上阅读完整文件。

06 安装之前

关于 faceless-explainer skill 的常见问题

以下回答来自 2026-09-14 读取到的 SKILL.md,而非某次实际运行的记录。

这在协作模式和自主模式下都能运行吗?

是的。在协作模式下,用户批准节点位于步骤 0、3 和 6,并在步骤 4 进行草图审核。在自主模式下,同样的摘要会作为提醒发布,草图环节并入构建流程,仅在步骤 6 保留一个预览确认问题。

如果我没有 HeyGen 账户用于语音或音乐怎么办?

步骤 0 在继续之前会显示登录状态。未登录时,音频会自动回退到本地引擎(TTS 使用 Kokoro)。你可以选择协作模式等待登录,或选择自主模式继续使用可用的本地引擎。

输出支持哪些视频格式?

横屏 1920x1080、竖屏 1080x1920 或方形 1080x1080。格式由 BRIEF.md 中的目标渠道决定,并在故事板的 frontmatter 中一次性设定。

Faceless Explainer

在一个真实的动效与视频任务上运行 faceless-explainer。

下载 OpenDesign,从其 SKILL.md 链接导入 faceless-explainer,粘贴上述提示词,在查看结果之前先阅读计划。

终端
npx skills add https://github.com/heygen-com/hyperframes --skill faceless-explainer

OpenDesign 桌面客户端

一套设计系统,让每一次创作都保持品牌一致

在完整的 Vibe Design Workspace 中,用同一套品牌规则生成网页、PPT、可交互原型、数据看板、图像与 HTML 视频。连接本地 Codex、Claude Code、Cursor 等编程助手,即可免费创作。

  • 覆盖网页、PPT、原型、数据看板、图像与视频
  • 140+ 设计系统,以及完整模板与技能库
  • 连接本地 Codex 与 21+ 款编程助手 · 免费使用
免费下载

支持 macOS 与 Windows