Communitygithub.com

BintzGavin/helios-skills

ブランドのリポジトリからプロモーション用ハイプビデオをエンドツーエンドで作成するためのガイド付きワークフローです。ブランドアイデンティティを抽出し、ビートに同期した音楽を生成し、Helios CLI経由でハイエンドなmotion.devコンポジションをレンダリングします。ブランドに沿ったプロモーション動画やハイプ動画を作成する際に使用します。

helios-skills とは?

このスキルは、Claude CodeなどのAIエージェントが、ブランドのリポジトリやマーケティングサイトのURLからブランド情報を抽出し、プロモーション用ハイプビデオを完全に自動生成するためのガイド付きワークフローを提供します。ユーザーは最初に2つの質問に答えるだけで、ブランド分析から音楽生成、ビート同期、motion.devを用いたアニメーション、そしてHelios CLIによるMP4レンダリングまでを実行できます。特に、ElevenLabsとffmpegを使用したBPM解析によるビート同期アニメーションが特徴で、ブランドのトンマナに合致したダイナミックな動画制作が可能です。内部のmotion-design-rulesも強制され、すべてのクリエイティブ決定がブランドアイデンティティに準拠します。

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

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

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

ドキュメント

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

ブランドアイデンティティを推測しないでください。コードベースを分析するか、提供されたURLをリサーチしてください。


実行パイプライン

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

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

  1. 「ブランドのリポジトリ内で作業していますか?それとも、URL(マーケティングサイトなど)を提供していただけますか?ブランドをオンラインでリサーチするために使用します。」

  2. 「背景音楽を生成しますか?「はい」の場合、環境変数にELEVEN_LABS_API_KEYが必要です。APIキーは 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構造
  • プロダクトポジショニング
  • UIコンポーネント
  • 既存のモーション使用

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

  • コアバリュープロポジション
  • ターゲットオーディエンス
  • トーンボイス
  • 視覚的密度
  • プライマリパレット
  • アクセントパレット
  • タイポグラフィの性格
  • 感情的なポジショニング

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


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

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

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

  • ブランドトーン
  • 感情的なアーク
  • ターゲット再生時間

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


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

以下を抽出:

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

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

すべてのアニメーションはこのタイミングマップに合わせる必要があります。


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

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

skills/guided/motion-design-rules

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


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

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

入力例:

15秒のハイプ動画を作成

出力:

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

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

  • 再生時間
  • アスペクト比
  • ブランドサマリー
  • モーション言語
  • ビートに同期したシーン分解
  • 正確なタイムスタンプ
  • ナレーション
  • 画面上のテキスト
  • 視覚的構成
  • 明示的な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.

関連スキル