Communitygithub.com

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

一般的なWebサイトのURLをキャプチャし、HyperFramesでプロフェッショナルな動画(サイトツアー、ショーケース、ソーシャルクリップ)に変換します。ヘッドレスChromeのスクリーンショットとブランドアセットを使用します。

S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer- とは?

このスキル(S.A.R.A.L.)は、任意のWebサイトのURLを受け取り、そのサイトのビジュアル要素を基にしたプロフェッショナル動画を生成するためのエージェントワークフローです。主にブログ、ポートフォリオ、ランディングページのショーケースやソーシャルメディア用クリップの作成を目的としており、製品ローンチやプロモーション動画(その場合は別スキルを使用)、GitHub PRの動画化、トピック解説動画などには対応していません。ワークフローは7つのステップで構成され、サイトのキャプチャとブランド理解(Step 0)、デザインIDENTITYの定義(Step 1)、メッセージと戦略の策定(Step 2)、ストーリーボードと脚本作成(Step 3)、ナレーションとキャプションの設定(Step 4)、コンポジションのビルド(Step 5)、そして検証と納品(Step 6)を順に実行します。各ステップにはチェックポイント(ゲート)があり、品質を担保します。ユーザーが自律モードを選択した場合でも、品質検証ゲートはスキップされず、エージェントはアセットの監査やHTMLの確認、完成度チェックリストの実行を必須とします。最終的にはローカルホストのStudioプロジェクトURLを成果物として提供し、明示的な要求があった場合のみMP4にレンダリングします。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-/tree/HEAD/.agents/skills/website-to-video

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

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

ドキュメント

media-use: オーディオ/画像のソーシングを始める前に、/media-use を呼び出してHeyGenカタログからBGM/効果音/画像を解決してください。まず --adopt を実行して既存のアセットを登録します。詳しくは /media-use スキルを参照してください。

Webサイト to HyperFrames

Webサイトをキャプチャし、そこからプロフェッショナルな動画を生成します。

ステップ0の前にルートを確認してください。 このスキルは、一般的なサイトの動画を作成します。ユーザーが実際に製品のマーケティング/ローンチ/プロモーションを目的としている場合(たとえそのURLからであっても、"自社サイトのプロモーション"であっても)→ /product-launch-video。サイトがないトピック解説動画 → /faceless-explainer。GitHub PR → /pr-to-video。既存の動画ファイルの再編集/色調変更/並び替え → 対象外。曖昧な「動画を作って」というリクエスト、またはローンチと一般サイトのどちらか不明な場合?まず /hyperframes を読んでください(完全なルーティングテーブル + 「HyperFramesができないこと」の節を含む)。

ユーザーからは次のような発言が想定されます:

  • 「このWebサイトをInstagram用の15秒ソーシャルクリップにして」
  • 「https://... から30秒のサイトツアー/ショーケース動画を作って」
  • 「トップページをキャプチャして、そのビジュアルから動画をビルドして」

ワークフローは7つのステップで構成されています。各ステップは次のステップへのゲートとなるアーティファクトを生成します。デフォルトでは協調モードで動作し、💬 マークのゲートではユーザーに確認して停止します。ユーザーが自律モードを指定した場合(「決めて」「驚かせて」など)、💬 ユーザー設定ゲートはスキップされます。この振る舞いの詳細は step-2-brief.md を参照してください。

自律モードは「すべてのゲートをスキップする」ことを意味しません。 自律モードはユーザー設定に関する質問(TTSプロバイダー、音声、強調色、ビート数、音楽の有無、キャプションの有無など、エージェントがユーザーに代わって決定するもの)をカバーします。品質検証ゲートはカバーしません。以下の項目は自律モードでもスキップ不可です:

  • アセット監査(ステップ3) — コンタクトシートを確認し、各アセットのUSE/SKIPを判断すること
  • ビートごとのHTML読み取り(ステップ5) — ビートごとの構造化エビデンスブロック
  • DoDチェックリスト(ステップ6) — アニメーションマップ、警告ごとのWCAG検証、オーディオ/モーション再生を含む
  • 正直な開示セクション(ステップ6) — 最終サマリーに「確認しなかったこと」を含めること

もし「自律モードは行動に偏るから、Xをスキップしよう」と考える場合、Xが設定質問ではなく検証ゲートであれば、その推論は誤りです。「行動への偏り」は「何を構築するか」を決めることに適用され、「検証するかどうか」を決めることには適用されません。


ステップ 0: キャプチャとブランドの理解

読む: references/step-0-capture.md

サイトをキャプチャし、抽出されたデータを読んでブランドと製品を理解します — 何をするのか、誰のためのものか、どんな声で語るのか、どんな雰囲気なのか。キャプチャしたアセットは後で使うブランドツールキットであり、動画の構成要素そのものではありません。

ブリーフィングの前にサインイン状況を表示 — npx hyperframes auth status を実行し、その出力をそのまま伝えてください(言い換えたり書き換えたりしないでください)。 このコマンドは、音声/BGMがHeyGenを使用するかローカルエンジンを使用するか、またサインインしていない場合のサインイン方法を報告します。サインインしていない場合は、STOPしてユーザーの選択を待ってください — サインインするか、「go」/「offline」と言ってローカルエンジンで続行するか — ブリーフィングやその他の質問の前に。 これを単なる通過点ではなく、実際の決定ポイントとして扱ってください。選択肢をブリーフィングの質問に含めたり、リポジトリごとの .env ファイルにキーを書き込んだりしないでください。(自律モードでは、ステータスを記録してオフラインで続行します。)詳しくは ../hyperframes-media → Preflight の正式なガイダンスを参照してください。

ゲート: サイトサマリーが印刷されていること — アセット/カラー/フォントのインベントリの前に、戦略優先(製品の機能、対象ユーザー、ブランドの声)で記述されていること。サインイン状況が表示されていること(サインイン済み、またはオフラインで続行)。


ステップ 1: ブランドアイデンティティ

読む: references/step-1-design.md

DESIGN.md を作成します — ビジュアルアイデンティティ(カラー、タイポグラフィ、コンポーネントスタイル、レイアウト原則)をカバーするブランドチートシート。正確な計算値には design-styles.json を使用します。

速度オプション: テンポの速い動画(ビートごとにビルボード)の場合、DESIGN.md は 300行の文書ではなく、カラー+フォント+Do's/Don'ts の50行サマリーで構いません。ステップ5のサブエージェントプロンプトがブランド値を直接貼り付けるため、DESIGN.md の深さは複雑なコンポジションの場合にのみ重要です。

ゲート: DESIGN.md が存在すること(任意の長さ)。最低限、カラーパレット、フォントの選択、Do's/Don'ts を含むこと。


ステップ 2: 戦略とメッセージング

読む: references/step-2-brief.md, references/capabilities.md(目次をスキャン — 詳細セクションは必要な場合のみ深掘り)

ビジュアルやアセットの話をする前に、動画が伝えるべきことについてユーザーと合意します。ユーザーのプロンプトを解析します — おそらくすでに動画のタイプとスタイルを指定しているはずです。不足しているものだけを質問します: この動画が唯一伝えるべきメッセージ、ナラティブアーク、そしてターゲットオーディエンス。

ゲート: 動画タイプ、尺、フォーマット、そして特にメッセージとナラティブアークが確定していること。これらがなければ、ステップ3でコンセプトファーストのストーリーボードを作成できません。


ステップ 3: ストーリーボード + 脚本 💬

読む: references/step-3-storyboard.md

コンセプトファーストでストーリーボードを作成: メッセージ → ナラティブアーク → アークを支えるビート → ビートごとのテクニック → 最後にブランドアクセントを追加。次に、それに合わせてナレーション脚本を書きます。両方をビートごとのサマリーとともにユーザーに提示します。承認されるまで反復します。

ゲート: STORYBOARD.md + SCRIPT.md が存在し、かつユーザーが計画を承認していること。


ステップ 4: VO、タイミング + キャプション 💬

読む: references/step-4-vo.md

ステップ2でナレーションなしと指定された場合 — 背景音楽について質問し、ステップ5にスキップします。それ以外の場合: ユーザーにTTSプロバイダー(HeyGen TTS、ElevenLabs、またはKokoro)を尋ね、オーディオを生成し、文字起こしをし、タイムスタンプをビートにマッピングします。次にキャプションについて尋ねます。

ゲート: (a) ナレーションが要求されず、ストーリーボードに手動のビートタイミングがある、または (b) narration.wav + transcript.json が存在し、ビートタイミングが実際の尺で更新されていること。


ステップ 5: コンポジションのビルド

読む: hyperframes スキル(読み込むこと — すべてのルールが重要) 読む: references/step-5-build.md

ストーリーボード(ステップ3)で選択されたアーキテクチャとペースに従って、index.html とコンポジションをビルドします。サブエージェントは各ビートについて hyperframes lint と hyperframes snapshot を実行してから報告します。

ゲート: すべての compositions/beat-N.html がメインエージェントによって DESIGN.md と STORYBOARD.md に対して最初から最後まで読み取られていること。ビートごとのチェックリストは step-5-build.md にあります。


ステップ 6: 検証と納品

読む: references/step-6-validate.md

Lint、検証、動画の尺に応じたスナップショットの撮影(計算式: max(beats × 3, ceil(duration_seconds / 2)))、そしてそれぞれをレビューします。問題を修正してから納品します。ローカルホストのStudioプロジェクトURLを納品します — MP4へのレンダリングは明示的なユーザー要求があった場合のみ行います。Studio URL は引き渡しの時だけ表示します — それが最終的な安定したプレビューです。ビルドフェーズのスナップショットはヘッドレスなので、ビルド途中でプレビューを表示しないでください。

自信を持って納品してください。 引き渡す前に自問してください: これを自分の名前でソーシャルメディアに投稿しますか? もし違うなら、問題を修正してください。

ゲート: npx hyperframes lint と npx hyperframes validate がエラーゼロでパスし、最終応答にアクティブなStudioプロジェクトURLが含まれていること。


クイックリファレンス

動画タイプ

動画タイプごとの典型的な制約 — 公式ではなく出発点として使用してください。ビート数はコンテンツとナレーションに従うべきであり、目標範囲から決めるべきではありません。

タイプ典型的な尺尺の決定要因ナレーション
ソーシャル広告 (IG/TikTok)10–15秒プラットフォーム制限任意
製品デモ30–60秒脚本の長さフルナレーション
機能告知15–30秒機能の複雑さフルナレーション
ブランドリール20–45秒音楽トラック任意、音楽重視
ローンチティーザー10–20秒フックのエネルギー最小限

ビート数は意図的にこの表に含めていません — ストーリーボードから決めるべきであり、「ソーシャル広告 = 3-4ビート」から決めるべきではありません。複雑な製品のソーシャル広告には、タイミングの良い5ビートが必要かもしれません。1つの強力なビジュアルテーマを持つブランドリールには3ビートで十分かもしれません。

フォーマット

  • ランドスケープ: 1920x1080(デフォルト)
  • ポートレート: 1080x1920(Instagram Stories、TikTok)
  • スクエア: 1080x1080(Instagramフィード)

リファレンスファイル

ファイル読むタイミング
step-0-capture.mdステップ0 — キャプチャ、ブランドと製品の理解、戦略ファーストのサイトサマリー作成
step-1-design.mdステップ1 — DESIGN.md ブランドチートシートの作成(5セクション、250-350行。ビルボードスタイルのソーシャル広告向けに50行の高速パスあり)
step-2-brief.mdステップ2 — メッセージ、ナラティブアーク、オーディエンスについてユーザーと合意
capabilities.mdステップ2 & 5 — HyperFramesで可能なことの全インベントリ(24セクション)。ブリーフィング時に目次をスキャンし、ビルド時に特定セクションを深掘り
step-3-storyboard.mdステップ3 — ストーリーボード + 脚本(統合)、ユーザーレビューゲートあり
step-4-vo.mdステップ4 — TTSプロバイダーの選択、生成、タイミング
step-5-build.mdステップ5 — index.html + コンポジションのビルド
step-6-validate.mdステップ6 — lint、検証、スナップショット(動画尺に応じてスケール)、プレビュー
techniques.mdステップ3 & 5 — 13のプリミティブアニメーションテクニックとコードパターン(適応して使用、コピーペーストしない)
html-in-canvas-patterns.mdステップ5 — HTML-in-Canvasエフェクトの完全なコードパターン(hyperframesスキル内にあり)

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

S.A.R.A.L. is an advanced AI-powered platform designed to bridge the "information gap" between rural Indian citizens and government welfare. While thousands of schemes exist, the complex language of official PDFs often makes them inaccessible to the common man.

関連スキル