Communitygithub.com

BintzGavin/helios-skills

端對端引導式工作流程,用於建立解說或導覽影片。能從儲存庫提取品牌識別、產生量身訂做的配樂,並產出由 motion.dev 驅動、透過 Helios CLI 渲染的敘事型影片。適用於製作運作原理說明、功能導覽或教學影片。

helios-skills 是什麼?

這個技能提供了一個完整的、逐步引導的流程,幫助使用者從零開始建立一個具備品牌一致性的解說影片。它首先會分析品牌儲存庫或提供的網址,以提取品牌識別(包括色調、語調、視覺風格等),確保所有創意決策與品牌一致。接著,它可以利用 ElevenLabs API 產生與品牌調性相符的背景音樂,並透過 ffmpeg 分析音訊的節拍,讓影片的轉場和文字出現時機與音樂同步。最後,它會產出一個 motion.dev 相容的創意規格書,並自動生成一個 HTML 檔案,然後使用 Helios CLI 將其渲染成高品質的 MP4 影片。這個技能支援 Claude Code、Cursor 等支援 Helios 的平台,非常適合需要快速製作高品質、品牌化之教學或產品導覽影片的開發者與團隊。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

您可能正在品牌儲存庫內操作,或是從外部情境開始工作。

請勿任意猜測品牌識別。請分析程式碼庫,或研究提供的網址。


執行管線

步驟 1 — 收集情境資訊

⛔ 停止。向使用者提問以下兩個問題:

  1. 「我們現在是在您品牌的儲存庫內嗎?或者您願意提供一個網址(例如您的行銷網站),讓我在線上研究您的品牌?」

  2. 「您希望產生背景音樂嗎?如果需要,您的環境中需要有 ELEVEN_LABS_API_KEY。您可以前往 https://elevenlabs.io → 個人資料 → API 金鑰 取得金鑰。」

等待使用者回覆這兩個問題。

請勿嘗試自行讀取 .env 檔案或驗證金鑰。 請信任使用者的回覆。

如果使用者提供網址,請在步驟 3 中使用該網址進行品牌研究,而非分析程式碼庫。 如果使用者婉拒音樂,請跳過步驟 4 和步驟 5。


步驟 2 — 確保 Helios 執行時期相依性

安裝所需的套件:

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

您將使用 DOM 模式進行渲染。


步驟 3 — 從儲存庫萃取品牌智慧

如果使用者提供的是一個網址而非儲存庫,請擷取該網址並從該即時網站中萃取 相同的品牌訊號。跳過與程式碼庫相關的項目 (Tailwind 設定、設計系統代號等),並專注於可見的品牌元素。

分析:

• Tailwind 設定或 CSS 變數 • 全域樣式表 • 設計系統代號 • Logo 素材 • 網站圖示 • 文件結構 • 功能描述 • 入門流程 • 說明文字與微文案 • 資訊架構 • 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 執行時期:

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

window.helios = helios;

helios.bindToDocumentTimeline({
  autoSyncAnimations: true
});

要求:

• 必須定義 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.

相關技能