Communitygithub.com

Manavv007/S.A.R.A.L.-スキーマ・アクセス・検索・分析・レイヤー

任意の長さや形式のカスタムHyperFramesビデオコンポジションを作成するためのフォールバックワークフローです。長尺やマルチシーンの作品、ブランド/シズルリール、モンタージュ、タイトルカード、静止ループ、自由形式のコンポジションなどに対応します。入力や長さに依存しません。入力が明確に特化ワークフローに適合する場合(販売製品、ウェブサイト、トピック解説、GitHub PR、既存映像、短いモーショングラフィック、Remotionポートなど)は、そちらを優先してください(`/hyperframes`を参照)。これらに該当しない場合の汎用フォールバックとしてのみ使用してください。

S.A.R.A.L.-スキーマ・アクセス・検索・分析・レイヤー とは?

S.A.R.A.L.は、HyperFramesエコシステムにおける汎用ビデオコンポジション作成のためのフォールバックスキルです。このスキルは、ブランドリール、モンタージュ、タイトルカード、長尺動画など、特定のワークフローが適用できないあらゆるカスタム動画作成に対応します。主にClaude CodeやCodexなどのAIエージェントで使用され、ビジュアルコンセプトの定義、デザインシステムの確立、プロンプト拡張、そして最終的なHTML+GSAPによるコンポジション構築までを段階的にガイドします。特筆すべきは、「レイアウト優先・アニメーション後」というアプローチで、まず静的な最終状態をHTML/CSSで構築し、その後にGSAPでアニメーションを追加することで、レイアウトの重複や欠落を防ぎます。また、音声、BGM、効果音、キャプションを統合する`hyperframes-media`エンジンを利用し、HeyGenやElevenLabs、Lyriaなどのサービスを自動的に切り替えて処理します。このスキルは、ハードゲート(設計段階での必須チェック)や詳細なドメイン固有のルールを参照することで、単なる「生成」ではなく「制作された」クオリティの動画出力を実現します。

対応~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/general-video

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

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

ドキュメント

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

general-video — 汎用ビデオワークフロー

構築前にルートを確認してください。 これはカスタムコンポジション作成のためのフォールバックです。入力が明確に特化ワークフローに適合する場合、そちらを優先してください:販売製品→/product-launch-video;一般サイト→/website-to-video;トピック解説→/faceless-explainer;GitHub PR→/pr-to-video;既存映像→/embedded-captions · /talking-head-recut;短いナレーションなしモーショングラフィック→/motion-graphics;Remotionポート→/remotion-to-hyperframes。対象外:ライブ/レンダリング時のデータ、完成動画のNLEスタイル編集、HyperFramesでキャプチャできない映像の制作。不明な場合は、最初に/hyperframesを読んでください。

依頼されたものを正確に構築してください。 タイトルカードはタイトルカードです。タイトルカード+サポートシーン3つ+アンビエント音楽+キャプションではありません。追加のシーンや要素が作品を真に向上させる場合は、提案 してください。黙って追加しないでください。小さな編集(色の修正、1つの長さの調整、1つの要素の追加)の場合は、計画手順をスキップして直接構築に進んでください。

アプローチ

発見 — オープンエンドなリクエストのみ

漠然とした探索的なリクエスト(「私たちのブランドのために何か作って」、「かっこいいイントロ」)の場合 — 色を選ぶ前に意図を理解してください:

  • オーディエンス — 誰が見るのか? 開発者/役員/一般消費者?
  • プラットフォーム — どこで再生されるのか? ソーシャル(15秒)/ウェブサイトヒーロー/プロダクトデモ/社内向け?
  • 優先事項 — 何が最も重要か? モーションの品質/コンテンツの正確性/ブランドの忠実性/速度?
  • バリエーション — ベストな1つか、意味のある異なる2〜3のオプション(異なるペース、エネルギー、構造 — 単なる色の変更ではなく)?

具体的なリクエスト(「タイトルカードを追加」、「シーン3のタイミングを修正」)の場合は、発見をスキップしてください。

ステップ1 — デザインシステム → hyperframes-creative

最初にビジュアルアイデンティティを確立します。プロジェクトにデザイン仕様がある場合は、それを読んでください(優先順位 frame.md → design.md → DESIGN.md;ブランドの真実として扱う — 正確な色、フォント、制約)。

仕様がない場合は、色やフォントを選ぶ前に hyperframes-creative/references/house-style.md と hyperframes-creative/references/video-composition.md の両方を読む必要があります。 house-style.md は「プロンプトを解釈し実際のコンテンツを生成する」オープナー、レイジーデフォルトリスト、レイヤーレシピを提供します。video-composition.md は、ビデオメディアの密度/スケール/前景ディテーリング(データバー、レジストレーションマーク、等幅メタデータ、「ユーザーが頼んでいない8〜10要素」)を提供し、これが「制作された」と「生成された」を区別します。片方だけ読むことが最も一般的なミスです — video-composition.md はエージェントが飛ばしがちで、まさにフラットで中央寄せのウェブページ風の出力を防ぐものです。パレットを自己発明してこれらをスキップしないでください。hyperframes-creative への移行はここでは必須であり、オプションの分岐ではありません。そこから、必要に応じて名前付きスタイル/ムード → references/visual-styles.md、またはインタラクティブピッカー → references/design-picker.md も取得します。仕様/スタイルはブランドを定義し、コンポジションルールを定義するものではありません。

角度を見つける(曖昧なブリーフ、仕様なし): 色を選ぶ前に、一文を書いてください — この名前/単語/トピックは何を連想させ、どのような視覚的な_世界_(比喩、設定、楽器、モチーフ)がそれを表現するか? 例:サイバーセキュリティツール → 金庫の扉/境界スキャンライン/錠前のタンブラー;瞑想アプリ → 潮汐、呼吸、ゆっくりとした光の広がり。被写体の_意味_を読んでください。単なる文字ではありません。文字通りのリスタイルではなく、具体的な角度を選んでください。これは、シングルシーン作品でのプロンプト拡張(ステップ2)の安価な代替であり、拡張は正しくスキップされます — そして、これはデザインされたコンセプトと、グラデーション上の一般的なロゴとの違いです。

ステップ2 — プロンプト拡張 → hyperframes-creative

すべてのマルチシーンコンポジションに対して実行します(シングルシーン作品と些細な編集はスキップ)。リクエストをデザイン仕様+ハウススタイルに基づいて、下流の作業が同じように読める一貫した中間表現に接地します。hyperframes-creative/references/prompt-expansion.md を参照してください。

ステップ3 — 計画

HTMLを書く前に、高いレベルで考えます:

  1. 何 — 視聴者体験:物語の弧、重要な瞬間、感情的なビート。
  2. 構造 — コンポジションの数、サブコンポ vs インライン、どのトラックがビデオ/オーディオ/オーバーレイ/キャプションを運ぶか。モノリシック単一ファイル vs モジュラーサブコンポの判断については、hyperframes-core/references/composition-patterns.md § つのアーキテクチャ(経験則:ハードシーンカットが3以上、または再利用されるシーンがある場合 → モジュール化;短いシングルシーン作品は1ファイルのまま)。
  3. リズム — 実装前にパターンに名前を付ける(例:fast-fast-SLOW-SHADER-hold);hyperframes-creative/references/beat-direction.md を参照。
  4. タイミング — どのクリップが長さを決定するか、トランジションがどこに配置されるか、ペーシング。
  5. レイアウト — 最初に最終状態を構築します(以下参照)。
  6. アニメーション — その後、hyperframes-animation を介してモーションを追加します。

アニメーションの前にレイアウト

すべての要素を、最も見える瞬間に配置します — 完全に入力され、正しく配置され、まだ退出していない状態。これを最初に静的なHTML+CSSとして記述します。まだGSAPは使わないでください。

理由: 要素をアニメーション開始状態(画面外、スケール0、不透明度0)に配置し、そこから_着地すると思われる_場所にトゥイーンすると、最終的なレイアウトを推測していることになり、重なりはレンダリングまで見えません。最初に最終状態を構築すれば、モーションを追加する前にレイアウトの問題を見つけて修正できます。

  1. 各シーンのヒーローフレームを特定します — 最も多くの要素が同時に表示される瞬間。それが構築するレイアウトです。
  2. そのフレームの静的なCSSを記述します。コンテンツコンテナは、絶対オフセットではなくパディングでシーンを埋める必要があります:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* パディングがコンテンツを配置;任意のシーンサイズを埋める */
  gap: 24px;
  box-sizing: border-box;
}

コンテンツコンテナに position: absolute; top: Npx を使用しないでください — コンテンツがスペースより高い場合にオーバーフローします。絶対配置は装飾用に予約してください。

⚠ 上記の width/height: 100% は、すべての祖先に解決された高さがある場合のみ機能します。 ルート <div data-composition-id> と .scene-content の間のラッパーはサイズ設定されている必要があります(ルートに position: relative; width: 1920px; height: 1080px — hyperframes-core → 「ルートはサイズ設定が必要」を参照)。これをスキップすると、flexコンテナは約0に収縮し、コンテンツは左上隅に積み重なり、最初のグリフはx=0でクリップされます — 一方 lint/inspect は0件の問題を報告します。そして、.scene-content に常に padding(≥80px)を保持してください:これはタイトルセーフマージンです。決して bare gap で置き換えないでください。

  1. エントランスを追加 — gsap.from() を使用して、画面外/非表示からCSS位置にアニメーションします(サブコンポジションでは、開始状態が明示的になるように gsap.fromTo() を推奨;hyperframes-core/references/sub-compositions.md を参照)。CSS位置が真実であり、トゥイーンはそこへの道のりです。
  2. 終了はトランジションで処理 — hyperframes-animation/transitions/ のシーントランジションルールに従い、最終シーンのみが要素をアニメーションで退出させます。シーン間のトランジションが終了そのものです。

時間を超えた共有スペース: 要素Aが要素Bが同じ領域に入る前に退出する場合でも、両方ともそれぞれのヒーローフレームに対して正しいCSS位置が必要です。タイムライン順序がそれらの共存を防ぎ、レイアウトステップが偶発的な重なりをキャッチします。レイヤードグロー/シャドウとzスタック深度は_意図的な_重なりです。このステップは_意図的でない_衝突(互いの上にある2つの見出し、フレームからはみ出すコンテンツ)をキャッチすることに関するものです。

構築 — ドメインスキルに委譲

これは、スキルの全範囲(description を参照)をそのリファレンスにマッピングします — 網羅的ではありません。意図がリストにない場合、hyperframes-creative(ルック/コンセプト)、hyperframes-animation(モーション)、hyperframes-core(契約)、hyperframes-media(オーディオ/キャプション)を経由してルーティングします。最初の行は追加的です — それをあなたの意図行と一緒に読んでください。どちらか一方だけではありません。

構築対象…最初に読むもの(順序通り)
常に — すべての非自明な作品に対して、以下の意図行に加えてhyperframes-creative/references/house-style.md + references/video-composition.md(ステップ1 / HARD-GATEでもゲートされています。「生成された」ではなく「制作された」前景ディテーリング)
キネティックタイポグラフィ / テキスト主体hyperframes-animation/techniques.md(キネティックタイプ)+ adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
タイトルカード / ローワーサード / オーバーレイ / PiP / 被写体背後テキストhyperframes-creative/references/composition-patterns.md +(中央揃え/サイズ調整フレーム用) hyperframes-core → 「ルートはサイズ設定が必要」
ロゴ / ブランドマーク リビールhyperframes-animation/rules/svg-path-draw.md(描画)+ rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
データ / 統計 / 数字hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
製品 / アプリ / UIデモhyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
オーディオリアクティブ / 音楽駆動型hyperframes-creative/references/audio-reactive.md(事前にバンドを抽出;モーションにマッピング)
ナレーション / ボイスオーバー / 音楽 / 効果音 / キャプションhyperframes-media → 共有オーディオエンジン scripts/audio.mjs(1回の呼び出し = TTS + BGM + SFX → audio_meta.json);hyperframes-core を介したキャプション作成+アセット配置。オーディオを参照。
マルチシーン / トランジションhyperframes-animation/transitions/overview.md 次に transitions/catalog.md(概要だけでは終わりません — GSAPレシピはカタログにあります)
モジュラー / サブコンポジションhyperframes-core/references/composition-patterns.md + references/sub-compositions.md

オーディオ:1つのエンジン(TTS · BGM · SFX)

作品がそれを必要とする場合のみ(「依頼されたものを正確に構築する」に従い — タイトルカードにアンビエント音楽は不要)。TTSを手作りしたり、コピーをベンダー調達したりしないでください。ニュートラルな audio_request.json を書き、hyperframes-media の共有エンジンを呼び出してください。これは1つのスイッチで自動的に劣化します — HeyGenクレデンシャルあり → HeyGen TTS + 音楽/SFX 検索;なし → ElevenLabs/Kokoro TTS、Lyria/MusicGen BGM 生成、およびバンドルされたSFXライブラリ。完全なフラグリスト+リクエスト/メタスキーマ:hyperframes-media/scripts/audio.mjs のヘッダーコメントを参照。

// audio_request.json — ナレーションセグメントごとに1行;`id` はあなたのもの(audio_meta を結合)
{
  "lines": [
    { "id": "s1", "text": "あなたのオープニングライン。", "sfx": ["whoosh"] },
    { "id": "s2", "text": "次のビート。" },
  ],
  "bgm": { "query": "calm cinematic underscore" }, // "mode" を省略 → 自動(HeyGenなら検索、それ以外は生成);"none" で無効化
}
# <MEDIA_DIR> = インストールされた hyperframes-media スキルディレクトリ(このスキルの兄弟)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

次に audio_meta.json を読みます:各 voices[].path +(bgm.path、sfx[])を <audio> トラックとしてマウントし、voices[].words をキャプションに使用します。すべて hyperframes-core(オーディオトラック+キャプション作成)に従ってください。BGMが生成パスを取った場合(bgm_pending: true)、最終レンダリング前に hyperframes-media/scripts/wait-bgm.mjs を実行してください。

出力チェックリスト → hyperframes-cli

…

[翻訳のため省略]

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-

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-

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

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.

関連スキル