Communitygithub.com

BintzGavin/helios-skills

端到端的引導式工作流程,用於建立社會證明或推薦影片。從儲存庫中萃取品牌識別,生成溫暖的配樂,並透過 Helios CLI 產生具信任感的 motion.dev 合成影片。適用於製作客戶推薦、評論精華或社會證明影片。

helios-skills 是什麼?

此技能提供一個完整的引導式工作流程,專為開發者和 AI 代理設計,以創建高品質的社會證明影片。它支援 Claude Code、Cursor、Codex 等平台,利用 Helios CLI 和 motion.dev 技術來合成影片。工作流程從擷取品牌資訊開始,無論是透過分析儲存庫還是研究提供的 URL。接著,它可以使用 ElevenLabs 生成音樂,並使用 ffmpeg 進行分析以實現節拍同步。最終輸出是一個 HTML 合成,該合成利用 motion.dev 動畫和 Helios 執行時期,呈現包含引用、統計數據和行動呼籲的信任建立結構。所有創意決定都必須與新建立或研究的品牌形象保持一致。此工具對行銷團隊特別有價值,他們需要快速製作一致的品牌推薦影片,無需手動影片編輯專業知識,確保每次輸出都是高品質、節拍同步且品牌對齊的。

相容平台~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 素材 • 網站圖示 (Favicon) • 推薦區塊或元件 • 評論/評分顯示 • 客戶標誌或合作夥伴區塊 • 信任標章或認證標誌 • 社會證明模式(計數器、統計數據、標誌) • 行銷文案與價值主張 • 行動呼籲 (CTA) 結構

建構內部品牌檔案:

• 核心價值主張 • 目標受眾 • 語氣(溫暖、真誠、值得信賴) • 視覺密度 • 主要調色盤 • 強調調色盤(暖色調以建立信任) • 字體特徵 • 社會證明策略(引用、統計數據、標誌,或組合)

所有創意決策必須與此保持一致。


步驟 4 — 生成原創音樂(如果沒有音樂則跳過)

使用現有的 ELEVEN_LABS_API_KEY 和 ElevenLabs。

生成符合以下條件的器樂曲目:

• 溫暖、振奮人心的基調 • 逐漸攀升至情感高潮 • 鼓舞人心但不激進 • 目標運行時間

將音訊儲存在本地。


步驟 5 — 使用 ffmpeg 分析音訊(如果沒有音樂則跳過)

萃取:

• BPM(每分鐘節拍數) • 節拍時間戳記 • 強拍 (Downbeats) • 能量峰值

建立節拍時間對應圖。

引用揭示必須落在強拍上。 姓名/職稱揭示應與節拍對齊。


步驟 6 — 閱讀動態設計規則

在產出創意規格之前,請閱讀並內化:

skills/guided/motion-design-rules

該技能中的每條規則對於此合成都是強制性的。


步驟 7 — 產出創意規格

您是使用 Helios 和 motion.dev 進行設計的高級創意總監和品牌信任建築師。

輸入範例: 製作一個 30 秒的推薦影片

輸出:

• 一份結構化的創意規格 • 包裹在單一程式碼區塊中 • 區塊外部不附帶任何說明

規格必須包含:

• 持續時間 • 長寬比(16:9) • 品牌摘要 • 動態語言(溫暖、優雅、從容) • 節拍同步場景分解 • 確切時間戳記 • 旁白(可選 — 可能採用純文字方法) • 螢幕文字(引用、歸屬、統計數據、行動呼籲) • 視覺構成(引用卡片、頭像、星級評分、客戶標誌) • 明確的 motion.dev 動畫行為 • 轉場邏輯(柔和淡入淡出、輕柔滑動、微幅縮放) • 圖層順序(背景紋理 → 引用卡片 → 頭像/照片 → 歸屬 → 統計數據) • 音訊方向 • 素材需求 • 字體層級結構(引用文字大、歸屬較小、統計數據突出)

僅使用 motion.dev 相容的術語。

推薦結構要求:

• 開場品牌時刻或情境設定(2-3 秒) • 引用 1:完整引用並附帶歸屬 • 引用 2:完整引用並附帶歸屬(如果時間允許) • 社會證明統計數據(數字、評分、客戶數量) • 結尾行動呼籲並附帶品牌標誌

每個引用區段: • 引用文字動畫進入(逐字打出或逐行淡入) • 短暫停頓以利閱讀 • 歸屬出現(姓名、職稱、公司) • 可選:客戶公司標誌或頭像


步驟 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 項統計數據 + 行動呼籲。優先使用最有力的引用。

如果未指定持續時間 預設為 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.

相關技能