Communitygithub.com

BintzGavin/helios-skills

ソーシャルプルーフやお客様の声の動画を作成するためのエンドツーエンドのガイド付きワークフローです。リポジトリからブランド情報を抽出し、温かみのあるサウンドトラックを生成し、Helios CLI経由でレンダリングされた信頼構築用のmotion.devコンポジションを作成します。お客様の声、レビューハイライト、ソーシャルプルーフ動画の作成時に使用します。

helios-skills とは?

このスキルは、Helios CLIとmotion.devを活用して、ブランドのリポジトリまたは指定されたURLからブランド情報を自動抽出し、ソーシャルプルーフやお客様の声の動画をエンドツーエンドで作成するためのワークフローを提供します。ユーザーは、ブランドのトーンに合わせた温かみのある楽曲をElevenLabsで生成し(オプション)、ffmpegでビート解析を行った上で、motion.devのアニメーションルールに従ったクリエイティブ仕様書を作成します。最終的に、DOMモードのHelios CLIを用いて高品質なMP4動画をレンダリングします。このスキルは、コードベースやマーケティングサイトからブランドのビジュアルアイデンティティ、価値提案、トーン・オブ・ボイスを抽出し、それに沿った信頼感のある動画コンテンツを生成する点が特徴です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/guided/testimonial-video

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ブランドのリポジトリ内で操作している場合と、外部コンテキストから作業している場合があります。

ブランド情報を推測しないでください。コードベースを分析するか、提供されたURLを調査してください。


実行パイプライン

ステップ1 — コンテキストの収集

⛔ 一時停止。ユーザーに以下の2つの質問をしてください:

  1. 「あなたのブランドのリポジトリ内にいますか?それとも、ブランドを調査するためのURL(例:マーケティングサイト)を提供していただけますか?」

  2. 「BGMを生成しますか?「はい」の場合、環境にELEVEN_LABS_API_KEYが必要です。キーは https://elevenlabs.io → プロフィール → APIキー で取得できます。」

ユーザーが両方の質問に回答するのを待ってください。

.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変数 • グローバルスタイルシート • デザイントークン • ロゴアセット • ファビコン • お客様の声セクションまたはコンポーネント • レビュー/評価表示 • 顧客ロゴまたはパートナーセクション • トラストバッジまたは認証マーク • ソーシャルプルーフパターン(カウンター、統計、ロゴ) • マーケティングコピーとバリュープロポジション • CTA構造

内部ブランドプロファイルを構築します:

• コアバリュープロポジション • ターゲットオーディエンス • トーンオブボイス(温かみ、本物、信頼性) • ビジュアル密度 • プライマリパレット • アクセントパレット(信頼感のための温かみのあるトーン) • タイポグラフィの特性 • ソーシャルプルーフ戦略(引用、統計、ロゴ、または組み合わせ)

すべてのクリエイティブな決定は、これに沿っている必要があります。


ステップ4 — オリジナル楽曲の生成(音楽なしの場合はスキップ)

既存のELEVEN_LABS_API_KEYを使用してElevenLabsを使用します。

以下の条件に合致するインストゥルメンタルトラックを生成します:

• 温かみのある、高揚感のあるトーン • 感情的なピークへの穏やかなビルド • 刺激的だが攻撃的ではない • ターゲットの再生時間

オーディオをローカルに保存します。


ステップ5 — ffmpegでオーディオを分析(音楽なしの場合はスキップ)

以下を抽出します:

• BPM • ビートのタイムスタンプ • ダウンビート • エネルギーピーク

ビートタイミングマップを作成します。

引用の表示はダウンビートに合わせる必要があります。 名前/役職の表示はビートに合わせる必要があります。


ステップ6 — モーションデザインルールを読む

クリエイティブ仕様書を作成する前に、以下を読み、内面化してください:

skills/guided/motion-design-rules

そのスキル内のすべてのルールは、このコンポジションにおいて必須です。


ステップ7 — クリエイティブ仕様書を作成

あなたは、motion.devを使用してHelios向けにデザインする、シニアクリエイティブディレクター兼ブランドトラストアーキテクトです。

入力例: 30秒の testimonial 動画を作成する

出力:

• 1つの構造化されたクリエイティブ仕様書 • 単一のコードブロックでラップ • 外部に説明なし

仕様書には以下を含める必要があります:

• 再生時間 • アスペクト比(16:9) • ブランドサマリー • モーション言語(温かみ、エレガント、意図的) • ビートに同期したシーン分割 • 正確なタイムスタンプ • ナレーション(オプション — テキストのみのアプローチも可) • 画面上のテキスト(引用、帰属、統計、CTA) • ビジュアル構成(引用カード、アバター、星評価、顧客ロゴ) • 明示的なmotion.devアニメーション動作 • トランジションロジック(優しいフェード、ソフトスライド、微妙なスケール) • レイヤー順序(背景テクスチャ → 引用カード → アバター/写真 → 帰属 → 統計) • オーディオの方向性 • アセット要件 • タイポグラフィ階層(引用テキストは大きく、帰属は小さく、統計は目立つように)

motion.dev互換の用語のみを使用します。

お客様の声構造の要件:

• オープニングのブランドモーメントまたはコンテキストセッター(2〜3秒) • 引用1:帰属付きの全文引用 • 引用2:帰属付きの全文引用(時間が許せば) • ソーシャルプルーフ統計(数字、評価、顧客数) • ブランドマーク付きのクロージングCTA

各引用セグメント: • 引用テキストがアニメーションで表示(タイプライター風または行ごとのフェードイン) • 読むための短いポーズ • 帰属が表示(名前、役職、会社) • オプション:顧客の会社ロゴまたはアバター


ステップ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.

関連スキル