プラグインのインストール: セットアップやfreshnessコマンドの前に、このスキルがHyperFramesプラグイン内にある場合は、プラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順をそのまま使用します。
最初に、このスキルを最新の状態に保ってください — ユーザーに確認してから実行:
npx hyperframes skills update faceless-explainer。すべてが最新の場合は高速なno-opになります。そうでなければ、このスキルとそれが依存するコアドメインスキルをリフレッシュしてから、それらを利用します。
media-use: オーディオ/画像/ロゴを調達する前に、
/media-useを呼び出してHeyGenカタログからBGM/効果音/画像を、ブランドロゴを公式ソースから解決します。最初に--adoptを実行して既存のアセットを登録してください。/media-useスキルを参照。ホストアプリが独自の音楽や効果音ツールを提供している場合は、それらを音楽と効果音に使用してください。
Faceless Explainer to HyperFrames
このスキルを使用して、テキストの塊を解説動画に変換します:デザインシステムを選択し、教育的なストーリーを計画し、HyperFramesでフレームごとに構築します。Facelessとは、すべてのビジュアルが後工程で生成されることを意味します — キャプチャステップや実際のアセットインベントリは存在しません。
フロントドアは
/hyperframesです。 あなたがオーケストレーターです。各ステップを実行し、そのゲートを確認してから、次のステップに進んでください。このスキルは、製品やキャプチャするウェブサイトがなく、テキストからトピックを説明するためのものです。他の意図、単に「動画を作って」とだけ言われた場合、または不確かな場合 → 最初に/hyperframesを読んでください — インテントレイヤーがすべてのルート決定を所有しており、BRIEF.mdなしでここに来た新規作成リクエストは、いずれにせよそれを通過します(セットアップの開始ルール)。
あなたはオーケストレーターです。videos/<project>/ で作業します。手順を順に実行し、各ゲートを通過してから続行してください。ユーザーゲートステップは、ステップ0、ステップ3、ステップ6です。ステップ0の前に ../hyperframes/references/brief-contract.md を読んでください — ゲートの種類と、BRIEF.md の flow/storyboard がステップ3/4/6のゲートを管理するモードをどのように導出するかが定義されています。ステップ5以外はすべて自分で実行します。ステップ5では、フレームごとに1つのサブエージェントをディスパッチします。デザインやモーションのルールはここに置かないでください。それらはフレームワーカーサブエージェント、このスキルのローカル ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/、および hyperframes-creative にあります。
ワークフロー:ステップ0 セットアップ → hyperframes.json; ステップ1 ブリーフ → capture/extracted/; ステップ2 デザインシステム → frame.md; ステップ3 ストーリーボード/スクリプト → STORYBOARD.md と SCRIPT.md; ステップ3.1 オーディオ → audio_meta.json; ステップ4 ビジュアルデザイン → 拡張された STORYBOARD.md; ステップ5 フレーム → compositions/frames/NN-*.html と index.html; ステップ6 最終レンダリング → renders/video.mp4。
ステップ0: セットアップ
目標:確定したブリーフを入力として取得し、HyperFramesプロジェクトを作成し、ブリーフを永続化します。
ブリーフはインテントレイヤーによって確認されており、ここで質問によって確認されるものではありません。 開始ルール、順に:(1) BRIEF.md が存在する → それを読み、何も質問しないでください — ブリーフは確定しており、その flow/storyboard がモードを導出します(ブリーフ契約 § 1)。(2) BRIEF.md はないがプロジェクトが存在する(ディスク上に hyperframes.json / STORYBOARD.md) → ストーリーボードのフロントマターと記録された設定から再開します。構築途中のプロジェクトに再質問しないでください。(3) どちらもない — ここに直接届いた新規作成リクエスト → /hyperframes を読み、そのインテントレイヤー(references/intent-interview.md)を実行します:レシピと記憶されたデフォルトをチェックし、このルートの質問(../hyperframes/references/routes/faceless-explainer.md)を実施し、ロックされたブリーフを返します。編集リクエストはこれらすべてをスキップします — 編集を行ってください。
hyperframes.json がない場合のみ初期化します。プロジェクト名 <project> はトピックからケバブケースで命名します。例:compound-interest-explained。ワークスペース名やタイムスタンプは使用しないでください。
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=faceless-explainer — init はインストールされているスキルをGitHub上の最新版と比較し、古いものがあればグローバルセットを更新します。
init 後、<PROJECT_ROOT> を videos/<project> とし、後続のすべての相対パスコマンドを作業ディレクトリとしてそのディレクトリで実行します。以下のコマンドでは、. は <PROJECT_ROOT> を意味します。.media、capture、または出力ファイルを呼び出し元のディレクトリに書き込まないでください。
init の直後に BRIEF.md を書き込んでください(決して前ではありません — init は空でないディレクトリを拒否します):インテントレイヤーのロックされたブリーフ、形式は ../hyperframes/references/brief-format.md に従います。<MEDIA_DIR> をインストールされた /media-use スキルディレクトリとして解決します。次に、各プリファレンスバックアップされた回答を node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . で記録します(brief-format.md でサブセットが指定されています)。インテントレイヤーがレシピを採用した場合は、node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name> を実行します。これにより、frame.md がプロジェクトにコピーされ(ステップ2はスキップされます)、ステップ3がドラフトするためのスケルトンが返されます。レシピは回答を埋めるものであり、承認ではありません。レビューゲートは引き続き実行されます。
セットアップを通過する前にサインインステータスを表示 — npx hyperframes auth status を実行し、その出力をそのまま中継します。これにより、音声/BGMがHeyGenを使用するかローカルエンジンを使用するか、およびサインアウトしている場合のサインイン方法が報告されます。以下のいずれかのブランチを適用します:
- 協調モード: ユーザーがサインインするか、明示的に
offline/goを選択するのを待ちます。 - 自律モード: ステータスを述べ、利用可能なローカルエンジンで続行します。
必要な機能に対してオフラインプロバイダーが存在しない場合、それを黙って省略しないでください。ブロッカーを表面化させてください。この判断を別の質問に折りたたんだり、リポジトリごとの .env にキーを書き込んだりしないでください。認証の所有権とオフラインフォールバック:/media-use references/setup-providers.md § Providers。
ゲート: hyperframes.json と BRIEF.md が存在する。プリファレンスバックアップされた回答が記録された(ブリーフ契約 § 2)。サインインステータスが表示された(サインイン済み、またはオフラインで続行)。
ステップ1: ブリーフ(キャプチャなし)
目標:ユーザーのテキストを情報源としてプロジェクトに取り込みます。ウェブサイトのキャプチャや実際のアセットはありません — これは顔出し不要の解説動画です。
ユーザーの入力をそのまま保存し、次に合成キャプチャパッケージを手動で作成します:
capture/extracted/visible-text.txt— 完全な記事/メモ/トピック/ブリーフ、そのまま。これは情報のソースであり、ストーリーテンプレートではありません(ステップ3で再形成します)。capture/extracted/tokens.json—{ "title": "", "description": "", "colors": [], "fonts": [] }。title/descriptionをブリーフから埋めます。colors/fontsは、ユーザーが明示的にブランドカラーやフォントを指定した場合を除き、空のままにします — その場合のみ追加します(デザインプリセットは完全なパレットを提供します)。
ユーザーがスクリプトを貼り付けた場合、または自分の文言をそのまま残したい場合は、それを user_script.txt としてそのまま保存します。VO_MODE(そのままか再構成か)は BRIEF.md から取得します — インテントレイヤーはスクリプトが到着したときにそれを尋ねます。ブリーフにどうしても欠けている場合にのみ、ここで一度質問し、その答えをステップ3のために保存します。
npx hyperframes capture を実行しないでください(URLはありません)。asset-descriptions.md を作成したり、capture/assets/ を設定したりしないでください — 顔出し不要のビジュアルはステップ4〜5で発明され、キャプチャされません。唯一の例外は、ユーザーが実際の画像を提供した場合です。その場合は public/<basename> の下に配置し、ステップ3のためにメモします。
ゲート: capture/extracted/visible-text.txt と capture/extracted/tokens.json が存在する。解説のトピックとターゲットオーディエンスを明確な一文で述べることができる。
ステップ2: デザインシステム
目標:出荷済みのフレームプリセットを1つ選択します。スクリプトがそれをこの動画の frame.md + キャプションスキンに変換します。
BRIEF.md が style_preset を指定している場合 — ユーザーがインテントレイヤーのショーケースから目で見て選んだものです — それを使用します。判断はブリーフが沈黙している場合のみあなたに委ねられます。その後、あなたは1つの判断を下します — どのプリセットか:../hyperframes-creative/references/design-spec.md を読み、../hyperframes-creative/frame-presets/ を閲覧します。トピック、トーン、およびオーディエンスに最も合うプリセットを選択します。次に実行します:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
スクリプトは残りを決定論的に行います:プリセットの FRAME.md を frame.md にコピーし、capture/extracted/tokens.json 内の任意のブランドトークンにリミックスします(ブランドカラーは役割ごとにプリセットのカラーキーにマッピングされ、プリセットの表示用+ボディフォントはブランドのものと交換されます)。プリセットのキャプションスキンを .hyperframes/caption-skin.html にコピーし、自己検証します(マッピングが壊れている場合は終了コード1で終了)。終了コード0で終了したらすぐに進みます — 仕様の手動編集は不要です。
顔出し不要の解説動画には通常ブランドカラー/フォントはありません(tokens.json のcolors/fontsは空) → スクリプトはプリセット独自のパレット(完全に出荷可能なデザイン)を保持します。ユーザーがブランドカラー/フォントを指定した場合のみ、それらを実行前に tokens.json に追加し、マッピングが本当に必要な場合にのみ、後で frame.md を手動で調整します。
ゲート: build-frame.mjs が終了コード0で終了した — frame.md が名前付きプリセットから存在する。そして(プリセットが出荷する場合).hyperframes/caption-skin.html がキャプションスキンソースとして存在する。選択されたプリセットがプリファレンスとして記録された(--key style_preset --workflow <this workflow>、ブリーフ契約 § 2)。
ステップ3: ストーリーボードとスクリプト
目標:テキストを承認されたフレームごとの教育計画に変換します。
../hyperframes-creative/references/story-spine.md(フック言語、証拠より先に価値、提案としてのストーリーボード、ソース追跡可能なビジュアル)、references/story-design.md、../hyperframes-animation/blueprints-index.md、../hyperframes/references/storyboard-format.md、および ../hyperframes/references/script-format.md を読みます。これらを使用して STORYBOARD.md を書き、ナレーションが必要な場合は SCRIPT.md を書きます。フロントマターの duration: をブリーフの length から設定します — 大まかな期待値であり、アセンブリは実際のカットがそれに対してどうかを報告します。
story-design.md を解説構造(概念/ハウツー/リスト記事/ストーリー)、フック戦略、明確化テクニック、感情のビート、タイプ列挙マッピング、および VO_MODE に使用します。動画のシーケンスはナラティブデザインから来ており、入力テキストの段落順ではありません — 並べ替え、統合、省略、圧縮を行います。ソフトガイドとして、../hyperframes-animation/blueprints-index.md の役割→ブループリントメニューを参照します:各ビートについて、その候補ブループリントが示唆する形状でナレーションを書き、該当するものがある場合はその候補 blueprint: ID をタグ付けします。教育的真実がどのビートが存在するかを決定します — ブループリントに適合させるためにビートを無理やり作らないでください。また、実績のある形状が利用可能だからといってビートを作り出さないでください。顔出し不要のビジュアルは後工程で生成されるため、フレームはアセットインベントリを持ちません:ユーザーが実際の public/<basename> 画像を提供した場合を除き、asset_candidates は空のままにします。ストーリーボードとスクリプトのリファレンスから必要な正確なフィールドを使用します。
ドラフト後、レビューループの計画パスを実行します — ../hyperframes/references/review-loop.md § 1:計画を提案として提示し、2つの質問をします — 承認するか変更するか、そしてスケッチを先に(推奨)またはスキップするか。フィードバックはチャット返信として届きます。承認されるまでループします。これはチェックポイントゲートです(ブリーフ契約 § 1):自律モードでは質問するものはありません — 同じ要約をヘッズアップとして投稿し、先に進みます。スケッチはビルドに統合され、1つの質問を含む最終プレビューはステップ6で行われます。
ゲート: STORYBOARD.md が存在し、すべてのフレームに必要なナラティブフィールドがある。SCRIPT.md がナレーションが必要な場合に存在する。ユーザーがフレームごとの計画を承認した(自律モード:要約がヘッズアップとして投稿された)。
ステップ3.1: オーディオ
目標:承認されたスクリプトからナレーション、ワードタイミング、音楽、およびオーディオメタデータを生成します。
ステップ3の承認後にオーディオを開始します。バックグラウンドで実行し、その後ステップ4に進みます(サインインステータスはステップ0ですでに表示されています。エンジンは自動的にフォールバックします)。
呼び出す前に、ユーザーのリクエストからナレーションボイスを選択します。 リクエストで声の性別やトーンが指定された場合、一致するボイスIDを選択し、--voice <id> で渡します。パイプラインのデフォルトはそれ以外の場合 Marcia(女性、HeyGen) / am_michael(Kokoro)です — したがって「男性の声」というリクエストは、フラグを渡さない限り黙って無視されます。ボイスIDはプロバイダー固有です。ステップ0のサインインステータスで選択されたプロバイダーに対して解決します:HeyGen(サインイン済み)は node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list(または GET /v3/voices?engine=starfish)経由。Kokoro(オフライン)は <MEDIA_DIR>/audio/references/tts.md のボイステーブル経由(接頭辞 am_/bm_ 男性、af_/bf_ 女性)。ユーザーが好みを表明しなかった場合、パイプラインのデフォルトの前に記憶されたボイス(ブリーフ契約 § 2)にフォールバックし、どれを使用したかを伝えます。--voice は、どちらも指定されていない場合にのみ省略します。ユーザーが今回の実行で明示的にボイスを選択した場合、それを記録します(prefs.mjs record --key voice)。
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <voice-id> &
オーディオスクリプトは、ナレーション、ワードタイミング、HeyGenの音楽ライブラリからのBGM検索、およびタイミングメタデータを処理します。BGMのムードはストーリーボードの music: フィールドから取得されます。これはHeyGen Audio APIを検索に使用し(生成ではありません)、TTSと同じ ~/.heygen 認証情報を使用します。プロバイダーの詳細については、../media-use/audio/references/tts.md を読んでください。ホストアプリの独自ツールが音楽や効果音を作成する場合、ファイルを assets/ の下に置き、audio_meta.json ファイルに "source": "host" とマークしてリストします:音楽は bgm { "path": "assets/…", "source": "host" } としてストーリーボードで music: none と共に。効果音は sfx エントリ { "frame": <n>, "file": "assets/…", "offset_s": 0, "duration_s": <長さ>, "source": "host" } として。すべてのオーディオパスはこれらを保持し、ホストサウンドがあるフレームは検索されたキューを受け取りません。
ナレーションがなく SCRIPT.md もない場合、音声生成をスキップします。ストーリーボードに音楽ムードがある場合、BGMは引き続き実行される可能性があります。
正規の完全無音マーカー(このオーディオモデルを再利用するワークフロー間で共有):STORYBOARD.md の先頭YAMLブロックに music: none、SCRIPT.md なし、かつ sfx: キューやホストオーディオがないこと。この組み合わせはプロジェクトを無音としてマークします — 以降のステップはオーディオをバイパスし、コンポジションは audio_meta.json の存在を要求しません。プロジェクトにBGM、効果音、またはホストオーディオがある場合、sfx: またはホストオーディオが存在するにもかかわらず music: none とマークされているストーリーボードは、不完全な状態(エラー)として扱われます。
ゲート: audio_meta.json が存在する(無音プロジェクトの場合は存在しない)。
ステップ4: ビジュアルデザイン
目標:各フレームにビジュアル指示を追加してストーリーボードを豊かにします。
../hyperframes-creative/references/visual-design-rules.md を読みます。これにより、ブループリントタイプごとにビジュアル設計の原則(レイアウト、アニメーション、データビズスタイル、色の使用方法の制約)が提供され、各フレームの visual_design: フィールドに記述的なスタイル指示とキーフレーム特有のパラメーターを添付する方法が説明されています。
references/composition-guidelines.md(フレームワーカーが尊重するレイアウトおよびタイミングの制約)も読みます。
次に、STORYBOARD.md の各フレームの visual_design: フィールドを充填します。各フレームは以下を取得する必要があります:
- 視覚的構成/レイアウトの記述
- 色とフォントの選択肢(
frame.mdのデザイントークンから) - アニメーションの手がかり(トランジション、イーズ)
- データビズのスタイル指示(該当する場合)
- ブループリント固有のパラメーター(該当する場合、ビジュアルデザインルールから)
asset_candidates— 顔出し不要の解説動画では何もありません(ユーザー提供のpublic/<basename>画像がある場合を除く)
ユーザー提供の画像がある場合、それが使用されるフレームの visual_design: にそのパスを含めます。
ゲート: STORYBOARD.md のすべてのフレームに充填された visual_design: フィールドがある。ビジュアル指示は visual-design-rules.md の原則に従っている。
ステップ5: フレーム
目標:各フレームのHTMLファイルと、それらをアセンブルするための index.html を作成します。
../hyperframes-animation/references/frame-worker.md を読みます。このスキルは、フレームワーカーサブエージェントを各フレームにディスパッチします(STORYBOARD.md に N フレームある場合は N 個のサブエージェントタスク)。
各フレームについて、フレームワーカーに以下を提供します:
- 充填された
visual_design:フィールドを持つストーリーボードフレームエントリ frame.md(グローバルなデザイン制約)- 関連するブループリント(
../hyperframes-animation/blueprints/から) - ビジュアルデザインルール(
../hyperframes-creative/references/visual-design-rules.md)
フレームワーカーは以下を作成します:
compositions/frames/NN-<slug>.html— フレームごとの完全なHTMLファイル。各フレームは単独でプレビュー可能で、正しいレイアウト、タイポグラフィ、アニメーションを含みます。compositions/index.html— すべてのフレームを正しい順序でインポートするメインHTMLファイル。
フレームワーカーサブエージェントは ../hyperframes-animation/rules/ のアニメーションルールと ../hyperframes-animation/blueprints/ のブループリントを使用することを確認します。フレームワーカーはHTMLが利用可能な場合はキャプションスキン(.hyperframes/caption-skin.html)も適用する必要があります。
各フレームファイルの生成後、それらが存在し、正しくリンクされていることを確認します。compositions/index.html はプレビュー目的で単独で開くことができる必要があります。
ゲート: すべての compositions/frames/NN-*.html ファイルが存在する。compositions/index.html が存在し、すべてのフレームを正しくインポートしている。
ステップ6: 最終レンダリングと配信
目標:最終動画をレンダリングし、レビューを収集します。
最終レンダリングコマンドを実行します。サインインステータスが決定したものに応じて(ステップ0から):
HeyGen(サインイン済み): npx hyperframes render --compositions compositions/ --out renders/video.mp4
オフライン/ローカル: npx hyperframes render --compositions compositions/ --out renders/video.mp4 --offline
注意: レンダリング前に、renders/ ディレクトリが存在することを確認してください(存在しない場合は作成します)。
レンダリング後、レビューゲートを実行します — ../hyperframes/references/review-loop.md § 3:
- 協調モード: 最終動画へのリンクを提示し、承認または変更を求めます。フィードバックがある場合はループします。
- 自律モード: 最終動画を確認用に投稿します。これは最終ゲートです。
承認されたら、プロジェクトを完了としてマークします。
ゲート: 動画が renders/video.mp4 にレンダリングされた。動画がレビューされ承認された(協調モードではユーザー承認、自律モードでは投稿済み)。
概要
このスキルは、任意のテキスト入力から構造化されたワークフローを通じて、顔出し不要の解説動画を生成します。主なステップは次のとおりです:
- セットアップ(ステップ0): プロジェクトの初期化とブリーフの確定
- ブリーフの取り込み(ステップ1): テキスト入力の保存
- デザイン選択(ステップ2): フレームプリセットの選択と適用
- ストーリーボード(ステップ3): フレームごとの教育計画の作成とレビュー
- オーディオ(ステップ3.1): ナレーション、音楽、効果音の生成
- ビジュアルデザイン(ステップ4): 各フレームのビジュアル指示の追加
- フレーム構築(ステップ5): 個々のHTMLフレームとメインインデックスの作成
- レンダリングと配信(ステップ6): 最終動画のレンダリングと承認
このスキルは、顔出し不要の解説動画に特化しており、製品発表やウェブサイトウォークスルー用の /product-launch-video スキルとは異なります。
参照:
../hyperframes/references/brief-contract.md— ゲートとモード../hyperframes/references/brief-format.md— BRIEF.mdの形式../hyperframes/references/storyboard-format.md— STORYBOARD.mdの形式../hyperframes/references/script-format.md— SCRIPT.mdの形式../hyperframes/references/review-loop.md— レビュープロセス../hyperframes-animation/references/frame-worker.md— フレームワーカーサブエージェント../hyperframes-animation/blueprints-index.md— ブループリントメニュー../hyperframes-creative/references/— クリエイティブ参照(ストーリー、デザイン、ビジュアルルール)references/story-design.md— 解説ストーリーデザインreferences/composition-guidelines.md— 構成ガイドライン