Communitygithub.com

BintzGavin/helios-skills

端到端的引导式工作流,用于创建品牌宣传视频。从代码库提取品牌标识,生成节拍同步的音乐,并通过 Helios CLI 渲染出高能量的 motion.dev 动画短片。适用于制作品牌一致性的宣传或推广视频。

helios-skills 是什么?

该技能提供一条完整的引导式工作流,帮助用户从零创建品牌宣传视频。它会自动分析代码库或指定 URL 中的品牌元素(如配色方案、字体、营销文案等),构建内部品牌画像。用户可选择通过 ElevenLabs 生成与品牌基调匹配的背景音乐,并利用 ffmpeg 分析音频节拍,确保所有动画与音乐同步。最后,技能会生成基于 motion.dev 的 HTML 合成文件,并通过 Helios CLI 渲染为高分辨率 MP4 视频。该技能支持 Claude Code、Codex、Cursor 等主流 AI 代理平台,要求环境中安装 Node.js 和 Helios 相关 npm 包,并可选配置 ELEVEN_LABS_API_KEY。

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

在你喜欢的 AI 中提问

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

文档

你可能位于品牌仓库内部,或者从外部上下文工作。

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


执行流水线

步骤 1 — 收集上下文

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

  1. “我们是在您品牌的仓库内,还是您想提供一个 URL(例如您的营销网站),以便我在线研究您的品牌?”

  2. “您想要生成背景音乐吗?如果需要,您需要在环境中设置 ELEVEN_LABS_API_KEY。您可以在 https://elevenlabs.io → 个人资料 → API 密钥 获取密钥。”

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

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

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


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

安装所需软件包:

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

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


步骤 3 — 从仓库提取品牌智能

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

分析:

• Tailwind 配置或 CSS 变量 • 全局样式表 • 设计令牌 • Logo 资源 • 网站图标 • Hero 区域 • 营销文案 • CTA 结构 • 产品定位 • UI 组件 • 现有 motion 使用情况

构建内部品牌画像:

• 核心价值主张 • 目标受众 • 语调 • 视觉密度 • 主色调 • 强调色 • 字体特征 • 情感定位

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


步骤 4 — 生成原创音乐(如果没有音乐则跳过)

使用 ElevenLabs 和现有的 ELEVEN_LABS_API_KEY。

生成符合以下条件的器乐音轨:

• 品牌基调 • 情感弧线 • 目标时长

将音频文件保存到本地。


步骤 5 — 使用 ffmpeg 分析音频(如果没有音乐则跳过)

提取:

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

创建节拍时间映射。

所有动画必须与此时间映射对齐。


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

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

skills/guided/motion-design-rules

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


步骤 7 — 生成创意说明书

你是资深创意总监和运动系统架构师,使用 motion.dev 为 Helios 设计。

输入示例: make a 15 second hype video

输出:

• 一份结构化的创意说明书 • 包裹在单个代码块中 • 外部不做任何说明

说明书必须包括:

• 时长 • 宽高比 • 品牌摘要 • 运动语言 • 节拍同步的场景分解 • 精确时间戳 • 画外音 • 屏幕文本 • 视觉构成 • 明确的 motion.dev 动画行为 • 过渡逻辑 • 分层顺序 • 音频方向 • 素材需求

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


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

根据创意说明书:

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

• 使用 HTML + CSS + motion.dev • 使用 WAAPI / CSS / motion.dev 实现动画 • 将动画对齐到节拍时间戳 • 包含生成的音频文件 • 具有精确的时长

暴露 Helios 运行时:

import { helios } from "@helios-project/core";

window.helios = helios;

helios.bindToDocumentTimeline({
  autoSyncAnimations: true
});

要求:

• window.helios 必须定义 • 必须调用 helios.bindToDocumentTimeline() • 必须启用 autoSyncAnimations: true • 所有 CSS 和 WAAPI 动画必须正确同步 • 不能有随机性 • 确定性的时间安排


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

使用以下命令渲染:

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

要求:

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

输出文件必须为:

output.mp4


运行时规则

如果时长 ≤ 15 秒 优先考虑冲击力和清晰度。

如果没有指定时长 默认为 30 秒。

永远不要复述原始提示。 永远不要解释推理过程。 创意说明书必须仅输出在单个代码块内。

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

End-to-end guided workflow for creating an explainer or walkthrough video. Extracts brand identity from the repo, generates a measured soundtrack, and produces a narrative-driven motion.dev composition rendered via Helios CLI. Use when making how-it-works, feature walkthrough, or educational videos.

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 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.

相关技能