Communitygithub.com

BintzGavin/helios-skills

端到端的引导式工作流,用于创建社交证明或推荐视频。从代码仓库提取品牌标识,生成温暖的背景音乐,并通过 Helios CLI 渲染出信任构建的 motion.dev 合成视频。适用于制作客户推荐、评论精选或社交证明视频。

helios-skills 是什么?

该技能提供了一个完整的引导式工作流,用于生成社交证明或推荐视频,特别适合在 Claude Code、Cursor 或 Codex 等 AI 代理环境中使用。它首先通过分析代码仓库或指定的营销 URL 来提取品牌标识,确保所有视觉和音乐创作决策与品牌调性一致。技能支持通过 ElevenLabs API 生成背景音乐(需 `ELEVEN_LABS_API_KEY`),并使用 ffmpeg 分析音频节拍,使文本出现与音乐节奏同步。最终,它利用 motion.dev 和 @helios-project/cli 渲染出高质量的 MP4 视频,所有动画时序均为确定性。该技能强调在输出创意规范时不解释推理过程,且要求遵循 motion-design-rules 技能中的强制规则,确保生成结构清晰、品牌一致的视频内容。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/guided/testimonial-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 资源 • 网站图标 • 推荐部分或组件 • 评论/评分展示 • 客户 Logo 或合作伙伴部分 • 信任徽章或认证标志 • 社交证明模式(计数器、统计信息、Logo) • 营销文案和价值主张 • CTA 结构

构建内部品牌档案:

• 核心价值主张 • 目标受众 • 语气(温暖、真实、可信) • 视觉密度 • 主要调色板 • 强调色板(暖色用于信任) • 字体特征 • 社交证明策略(引用、统计、Logo 或组合)

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


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

使用现有的 ELEVEN_LABS_API_KEY 使用 ElevenLabs。

生成与之匹配的器乐音轨:

• 温暖、振奋的基调 • 逐渐推向情感高潮 • 鼓舞人心但不激进 • 目标时长

将音频保存到本地。


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

提取:

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

创建节拍时间映射。

引用展示必须落在强拍上。 姓名/头衔展示应与节拍对齐。


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

在制作创意规范之前,请阅读并内化:

skills/guided/motion-design-rules

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


步骤 7 — 生成创意规范

您是使用 Helios 和 motion.dev 设计的高级创意总监和品牌信任架构师。

输入示例: 制作一个 30 秒的推荐视频

输出:

• 一个结构化的创意规范 • 包裹在单个代码块中 • 代码块外不作任何解释

规范必须包括:

• 时长 • 宽高比 (16:9) • 品牌摘要 • 运动语言(温暖、优雅、从容) • 节拍同步的场景分解 • 精确的时间戳 • 画外音(可选 — 可仅使用文本方式) • 屏幕文本(引用、署名、统计信息、CTA) • 视觉构图(引用卡片、头像、星级评分、客户 Logo) • 明确的 motion.dev 动画行为 • 过渡逻辑(柔和淡入、轻柔滑动、轻微缩放) • 图层顺序(背景纹理 → 引用卡片 → 头像/照片 → 署名 → 统计信息) • 音频方向 • 资源需求 • 字体层级(引用文本大、署名小、统计信息突出)

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

推荐结构要求:

• 开场品牌时刻或情境设定(2-3 秒) • 引用 1:完整引用及署名 • 引用 2:完整引用及署名(如果时长允许) • 社交证明统计信息(数字、评分、客户数量) • 结尾 CTA 及品牌标志

每个引用片段: • 引用文本动画进入(逐字击出或逐行淡入) • 短暂停顿以供阅读 • 署名出现(姓名、头衔、公司) • 可选:客户公司 Logo 或头像


步骤 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 动画必须正确同步 • 无随机性 • 确定性时序 • 每个引用必须保持可读至少 4 秒 • 星级评分应顺序动画


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

使用以下命令渲染:

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

要求:

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

输出文件必须是:

output.mp4


运行时规则

如果时长 ≤ 15 秒 显示 1 条引用 + 1 个统计信息 + CTA。优先使用最强引用。

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

任何时长的引用最多 3 条。 引用必须是真实的或具有代表性 — 切勿编造。 如果仓库中没有推荐内容,请使用带有清晰标签的占位结构。

不要重述原始提示。 不要解释推理过程。 创意规范必须仅输出在单个代码块内部。

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

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

相关技能