Communitygithub.com

BintzGavin/helios-skills

端到端引导式工作流,用于创建解说或导览视频。从仓库提取品牌标识,生成定制的背景音乐,并制作由叙事驱动的 motion.dev 合成视频,最终通过 Helios CLI 渲染。适用于制作原理介绍、功能导览或教学视频。

helios-skills 是什么?

这是一个端到端的引导式技能,旨在帮助用户快速创建专业品质的解说或产品导览视频。它通过自动化品牌分析、音乐生成和视频合成,将复杂的制作流程简化为一个可执行的步骤序列。该技能首先要求用户明确工作上下文(品牌仓库或外部URL),并询问是否需要生成背景音乐。随后,它会自动分析代码库或网站以提取品牌标识(如配色、字体、语气),并利用 ElevenLabs API 生成与品牌调性匹配的背景音乐,再通过 ffmpeg 分析音频节拍以同步动画。技能的核心是生成一份结构化的创意规格书,并基于 motion.dev 框架和 Helios CLI 实现一个 CSS/WAAPI 驱动的 HTML 合成视频。最终产出是一个 16:9 的 MP4 文件,支持精确的节奏同步、清晰的叙事结构(问题-解决方案-分步演示)和可读的屏幕文本。它高度依赖用户提供的 ELEVEN_LABS_API_KEY 和现有的 Helios 包,适用于 Claude Code、Cursor 等支持 shell 命令和文件生成的 AI 代理平台。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/guided/explainer-video

在你喜欢的 AI 中提问

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

文档

你可能正在品牌的仓库内操作,或者从外部上下文开始工作。

不要猜测品牌标识。要么分析代码库,要么研究提供的 URL。


执行管道

第 1 步 — 收集上下文

⛔ 停止。向用户询问以下两个问题:

  1. "我们是否在你的品牌仓库内?或者你希望提供一个 URL(例如你的营销网站),以便我在线研究你的品牌?"

  2. "您是否需要生成背景音乐?如果需要,您的环境中需要有 ELEVEN_LABS_API_KEY。您可以在 https://elevenlabs.io → 个人资料 → API 密钥 获取一个。"

等待用户对两个问题做出响应。

不要尝试自行读取 .env 文件或验证密钥。 信任用户的响应。

如果用户提供了 URL,则在第 3 步中使用该 URL 进行品牌研究,而不是分析代码库。 如果用户拒绝音乐,则跳过第 4 步和第 5 步。


第 2 步 — 确保 Helios 运行时依赖

安装所需的包:

npm install @helios-project/core @helios-project/renderer @helios-project/cli

你将使用 DOM 模式进行渲染。


第 3 步 — 从仓库提取品牌信息

如果用户提供了 URL 而不是仓库,请获取该 URL 并从实时网站中提取相同的品牌信号。跳过特定于代码库的项目(Tailwind 配置、设计令牌等),专注于可见的品牌元素。

分析:

• Tailwind 配置或 CSS 变量 • 全局样式表 • 设计令牌 • Logo 素材 • Favicon • 文档结构 • 功能描述 • 用户引导流程 • 帮助文本和微文案 • 信息架构 • UI 组件 • 现有动画使用情况

构建内部品牌档案:

• 核心价值主张 • 目标受众 • 语气(指导性、支持性、权威性) • 视觉密度 • 主色调 • 强调色 • 字体特征 • 信息层级模式 • 解释风格(视觉优先 vs 文本密集)

所有创意决策必须与此保持一致。


第 4 步 — 生成原创音乐(如果不需要音乐则跳过)

使用现有的 ELEVEN_LABS_API_KEY 调用 ElevenLabs。

生成符合以下要求的器乐音轨:

• 平静、支持性的基调 • 稳定的进展,无剧烈高潮 • 微妙的背景存在(不得与旁白竞争) • 目标时长

将音频保存到本地。


第 5 步 — 使用 ffmpeg 分析音频(如果不需要音乐则跳过)

提取:

• BPM • 节拍时间戳 • 重拍 • 能量峰值

创建节拍时序图。

章节过渡应与重拍对齐。 屏幕文字显示应与节拍对齐。


第 6 步 — 阅读运动设计规则

在生成创意规格书之前,请阅读并内化:

skills/guided/motion-design-rules

该技能中的每条规则对于此合成都是强制性的。


第 7 步 — 生成创意规格书

你是一位高级创意总监和教学设计架构师,使用 motion.dev 为 Helios 进行设计。

输入示例: 在 60 秒内解释我们的结账流程如何工作

输出:

• 一份结构化的创意规格书 • 包裹在单个代码块中 • 外部无任何解释

规格书必须包含:

• 时长 • 宽高比(16:9) • 品牌摘要 • 叙事弧线(引入 → 问题 → 解决方案 → 工作原理 → 行动号召) • 动画语言(沉稳、从容、递进) • 节拍同步的章节分解 • 每个章节的精确时间戳 • 旁白脚本(对话式、清晰) • 屏幕文字(章节标题、功能标签、步骤编号) • 视觉构图(清晰的布局、充足的留白) • 明确的 motion.dev 动画行为 • 过渡逻辑(章节之间的平滑交叉淡入淡出,内容的滑入效果) • 图层顺序 • 音频方向 • 素材需求 • 步骤指示器或进度标记

仅使用 motion.dev 兼容的术语。

叙事结构要求:

• 开场钩子(前 5 秒) • 问题识别 • 解决方案引入 • 分步演示 • 总结和行动号召


第 8 步 — 实现基于 DOM 的 Helios 合成

根据创意规格书:

创建一个 composition.html 文件,该文件:

• 使用 HTML + CSS + motion.dev • 使用 WAAPI / CSS / motion.dev 实现动画 • 将章节过渡与重拍对齐 • 使用带步骤编号的清晰章节标题 • 包含生成的音频文件 • 具有精确的时长 • 优先考虑可读性和视觉清晰度

暴露 Helios 运行时:

<script type="module">
import { helios } from "@helios-project/core";

window.helios = helios;

helios.bindToDocumentTimeline({
  autoSyncAnimations: true
});
</script>

要求:

• 必须定义 window.helios • 必须调用 helios.bindToDocumentTimeline() • 必须启用 autoSyncAnimations: true • 所有 CSS 和 WAAPI 动画必须正确同步 • 无随机性 • 确定性定时 • 文本在屏幕上的停留时间必须足够阅读(每条关键信息至少 3 秒)


第 9 步 — 使用官方 Helios CLI 渲染(DOM 模式)

使用以下命令渲染:

npx @helios-project/cli render ./composition.html -o output.mp4

要求:

• 16:9 宽高比 • 正确的时长 • 附加音频 • CSS 和 WAAPI 完全同步 • 高质量 MP4 输出

输出文件必须为:

output.mp4


运行时规则

如果时长 ≤ 30 秒 压缩为:钩子 → 核心概念 → 行动号召。

如果未指定时长 默认时长为 60 秒。

任何时长的章节数最多为 5 个。 每个章节必须有清晰的屏幕标题。 节奏必须确保可理解性 — 切勿仓促传递信息。

切勿重述原始提示。 切勿解释推理过程。 创意规格书必须仅输出在单个代码块内。

Individual skills in this repo

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

BintzGavin/helios-skills

Make a video, MP4, GIF, animation, music video, short film, explainer, chart animation, product demo, logo reveal or social clip from code. Write one HTML page that draws any frame from its time t, render it frame-exact to MP4 with Helios, check stills and contact sheets, and add a soundtrack. Use whenever the user asks for a video or an animation file.

BintzGavin/helios-skills

>- Story-first motion design philosophy for animated video: motion must earn its place; arc (establish, complicate, resolve); show vs tell; shots as units of thought; quiet vs loud motion; Disney principles with restraint; timing heuristics; composition; grammar by medium (product demos, logos, data viz, explainers); technical commitments (deterministic time, scrubbability, refs); cutting discipline; explicit anti-patterns. Use when planning, storyboarding, critiquing, or implementing programmatic or motion-driven video (Helios, Remotion, explainers, loops, UI capture, logo reveals), or when the user asks for motion direction, pacing, or visual-story structure.

BintzGavin/helios-skills

>- End-to-end production plan template for feeling-first cinematic product promos: brief interrogation, 45s beat structure (cold open through brand), hero-element metaphor, storyboard fidelity ladder, visual system (palette, type, camera, texture), motion mix and easing vocabulary, audio and captions, tooling (animatic through HTML or AE), deliverables matrix, accessibility, review milestones, and compromises to accept or refuse. Use when planning, pitching, storyboarding, or producing polished brand films for any SaaS or consumer product—not category-specific; pair with skills/design/animated-video-philosophy for broader motion principles.

BintzGavin/helios-skills

Patterns for using Helios with Framer Motion. Use when you want to use Framer Motion's physics and transitions but need frame-perfect synchronization with Helios.

BintzGavin/helios-skills

Patterns for using Helios with GSAP (GreenSock). Use when integrating GSAP timelines with the Helios timeline for precise scrubbing and rendering.

BintzGavin/helios-skills

Motion design framework for programmatic video. Defines anti-slideshow architecture, visual layering, physics-based easing, choreography rules, and quality validation. Reference this skill from any guided video skill.

BintzGavin/helios-skills

End-to-end guided workflow for creating a promotional hype video. Extracts brand identity from the repo, generates beat-synced music, and produces a high-energy motion.dev composition rendered via Helios CLI. Use when making brand-aligned promo or hype videos.

BintzGavin/helios-skills

End-to-end guided workflow for creating a social proof or testimonial video. Extracts brand identity from the repo, generates a warm soundtrack, and produces a trust-building motion.dev composition rendered via Helios CLI. Use when making customer testimonial, review highlight, or social proof videos.

BintzGavin/helios-skills

Workflow for rendering a Helios composition to a video file. Use when you need to automate video production or export a high-quality animation.

相关技能