Communitygithub.com

BintzGavin/helios-skills

解説動画やウォークスルー動画を作成するためのエンドツーエンドのガイド付きワークフローです。リポジトリからブランドアイデンティティを抽出し、測定されたサウンドトラックを生成し、Helios CLI を介してレンダリングされるナラティブ駆動の motion.dev コンポジションを作成します。仕組みの説明、機能のウォークスルー、教育用動画に最適です。

helios-skills とは?

このスキルは、Helios CLI と motion.dev を活用して、プロフェッショナルな解説動画を体系的に作成するための完全なパイプラインを提供します。まず、コードベースまたは提供されたURLからブランドのアイデンティティ(カラーパレット、トーン、ビジュアルスタイル)を収集し、動画のクリエイティブな方向性を決定します。次に、ElevenLabs を使用して落ち着いた雰囲気のBGMを生成し、ffmpeg で解析することで、ビートやダウンビートに合わせたセクション遷移とテキスト表示を実現します。motion-design-rules スキルで定義された必須ルールに従い、詳細なクリエイティブ仕様(ナラティブアーク、タイムスタンプ、音声台本、オンスクリーンテキスト、アニメーション動作)を生成します。最終的に、Helios の DOM モードを使用して composition.html を作成し、Helios CLI でレンダリングし、16:9 の高品質な MP4 ファイルを出力します。このスキルは、コードベース分析によるブランド抽出、音楽生成とビート同期、Helios エコシステムとの統合といった特徴を持ち、Claude Code や Codex といった AI エージェントプラットフォーム上で動作するように設計されています。

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

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

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

ドキュメント

あなたはブランドのリポジトリ内で操作しているか、外部のコンテキストから作業している可能性があります。

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


実行パイプライン

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

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

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

  2. 「生成されたBGMは必要ですか?必要な場合は、環境変数 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 変数 • グローバルスタイルシート • デザイントークン • ロゴアセット • ファビコン • ドキュメント構造 • 機能説明 • オンボーディングフロー • ヘルプテキストとマイクロコピー • 情報アーキテクチャ • UI コンポーネント • 既存のモーション使用

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

• コアバリュープロポジション • ターゲットオーディエンス • トーンの声(教育的、支援的、権威的) • ビジュアル密度 • プライマリパレット • アクセントパレット • タイポグラフィの特性 • 情報階層パターン • 説明スタイル(ビジュアルファースト vs テキストヘビー)

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


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

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

以下の条件に合ったインストゥルメンタルトラックを生成:

• 落ち着いた、サポート的なトーン • 劇的なピークのない安定した進行 • 控えめなバックグラウンド存在(ナレーションと競合しないこと) • 目標尺

音声をローカルに保存。


ステップ 5 — ffmpeg で音声を分析(BGMなしの場合はスキップ)

抽出:

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

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

セクション遷移はダウンビートに合わせる必要があります。

画面上のテキストの表示はビートに合わせる必要があります。


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

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

skills/guided/motion-design-rules

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


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

あなたは、Helios と motion.dev 向けにデザインするシニアクリエイティブディレクター兼インストラクショナルデザインアーキテクトです。

入力例: 「60秒でチェックアウトフローの仕組みを説明してください」

出力:

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

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

• 尺 • アスペクト比(16:9) • ブランド概要 • ナラティブアーク(導入 → 問題 → 解決策 → 仕組み → CTA) • モーション言語(測定された、意図的な、段階的な) • ビート同期されたセクションの内訳 • セクションごとの正確なタイムスタンプ • ナレーションスクリプト(会話調、明確) • 画面上のテキスト(セクションヘッダー、機能ラベル、ステップ番号) • ビジュアル構成(クリーンなレイアウト、十分な余白) • 明示的な motion.dev アニメーション動作 • トランジションロジック(セクション間のスムーズなクロスフェード、コンテンツのスライドイン) • レイヤリング順序 • 音声ディレクション • アセット要件 • ステップインジケーターまたは進捗マーカー

motion.dev 互換の用語のみを使用してください。

ナラティブ構造の要件:

• オープニングフック(最初の5秒) • 問題の特定 • 解決策の紹介 • ステップバイステップのウォークスルー • サマリーと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アニメーションが正しく同期する必要があります • ランダム性なし • 決定論的なタイミング • テキストは読み取るのに十分な時間、画面に表示される必要があります(キーメッセージごとに最低3秒)


ステップ 9 — 公式Helios CLI(DOMモード)を使用してレンダリング

以下でレンダリング:

npx @helios-project/cli render ./composition.html -o output.mp4

要件:

• 16:9のアスペクト比 • 正しい尺 • 音声が添付されている • CSSとWAAPIが完全に同期 • 高品質なMP4出力

出力ファイルは以下である必要があります:

output.mp4

ランタイムルール

尺 ≤ 30秒の場合 以下に圧縮: フック → コアコンセプト → CTA。

尺が指定されていない場合 デフォルトは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.

関連スキル