Communitygithub.com

BintzGavin/helios-skills

端到端引導式工作流程,用於製作品牌宣傳短片。從儲存庫提取品牌識別,生成與節拍同步的音樂,並透過 Helios CLI 渲染為充滿活力的 motion.dev 組合。適合製作品牌一致的宣傳或 hype 影片。

helios-skills 是什麼?

這個技能提供一個完整、引導式的工作流程,用於建立品牌宣傳短片。它能自動從指定的程式碼儲存庫或網站 URL 中提取品牌識別元素(如設計標記、色板、語調等),並將其整合到影片創作過程中。使用者可以選擇是否使用 ElevenLabs API 生成與品牌調性相符的自訂背景音樂,並透過 ffmpeg 分析音訊的節奏和能量峰值,確保所有動畫與音樂完美同步。最終,它會使用 motion.dev 和 Helios CLI 生成一個可直接渲染的 HTML 組合檔案,產出高品質的 MP4 宣傳影片。支援的平台包括 Claude Code、Coder、Cursor 和 Codex。此技能特別適合需要快速製作品牌一致、高能量的行銷影片或社交媒體內容的開發者。其關鍵優勢在於自動化的品牌分析、可選的音樂生成以及精準的節拍同步動畫,大幅簡化了傳統影片製作流程中繁瑣的對齊與手動調整工作。

相容平台~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 → Profile → API Keys 取得。」

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

不要嘗試自行讀取 .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 元件 • 現有的動態使用

建立內部品牌設定檔:

• 核心價值主張 • 目標受眾 • 語調 • 視覺密度 • 主要色板 • 強調色板 • 字體特性 • 情感定位

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


步驟 4 — 生成原創音樂(若無音樂則跳過)

使用 ElevenLabs 和現有的 ELEVEN_LABS_API_KEY。

生成符合以下條件的純樂器軌道:

• 品牌調性 • 情感弧線 • 目標播放時間

將音訊儲存在本地。


步驟 5 — 使用 ffmpeg 分析音訊(若無音樂則跳過)

提取:

• BPM • 節拍時間戳 • 重拍 • 能量峰值

建立節拍時間對應表。

所有動畫必須與此時間對應表同步。


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

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

skills/guided/motion-design-rules

該技能中的每一條規則對這個組合都是強制性的。


步驟 7 — 產出創意規格

你是一位資深創意總監和動態系統架構師,正在使用 motion.dev 為 Helios 進行設計。

輸入範例: 製作一個 15 秒的 hype 影片

輸出:

• 一個結構化的創意規格 • 包覆在單一程式碼區塊中 • 區塊外不加任何說明

規格必須包含:

• 時長 • 長寬比 • 品牌摘要 • 動態語言 • 與節拍同步的場景細分 • 精確的時間戳 • 旁白 • 螢幕文字 • 視覺構成 • 明確的 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.

相關技能