Communitygithub.com

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

HyperFrames CLI 開発ループ。`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`、`remove-background` の実行時、または HyperFrames のビルド/レンダリング環境のトラブルシューティング時に使用します。AWS Lambda クラウドレンダリング(`hyperframes lambda deploy / render / progress / destroy / policies`)のエントリポイントです。

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

このスキルは、HyperFrames CLI の全機能をカバーするエージェント向けリファレンスです。プロジェクトの初期化、コンポジションの作成・検証、プレビュー、レンダリング、AWS Lambda を使用したクラウドレンダリングまで、ビデオ制作パイプライン全体を統制します。Node.js >= 22 と FFmpeg を必要とし、すべてのコマンドは `npx hyperframes` を介して実行します。特筆すべき点として、`--json` フラグによる機械可読な出力、レンダリング前のユーザー承認ゲート、`snapshot` コマンドによるサブコンポジションのクロスファイルマウント障害の検出など、エージェントが自律的に動作するための堅牢な設計がなされています。また、`lint`、`validate`、`inspect` の各チェックは単一コンポジション単位で動作するため、マルチファイル構成のプロジェクトでは `snapshot` による視覚的スモークテストが必須となります。このスキルは、Codex、Claude Code、Cursor などの AI エージェント環境で使用することを想定しています。

対応~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/hyperframes-cli

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

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

ドキュメント

HyperFrames CLI

すべての操作は、プロジェクトの指示がローカルラッパーを指定していない限り、npx hyperframes を介して実行します。ローカルラッパーが存在する場合は、それを正確に遵守してください。Node.js >= 22 と FFmpeg が必要です。

ワークフロー

  1. スキャフォールド — npx hyperframes init my-video(または URL からの capture)
  2. 作成 — HTML コンポジションを作成(hyperframes-core スキルを参照)
  3. Lint — npx hyperframes lint
  4. 検証 — npx hyperframes validate(実行時エラー + コントラスト)
  5. 視覚的インスペクション — npx hyperframes inspect
  6. プレビュー — npx hyperframes preview で Studio(タイムラインエディタ)が開きます。ユーザーはここで手動で何でも編集できます(視聴だけでなく)。そこで確認後、レンダリングの前にユーザーに問い合わせてください。
  7. レンダリング — 次のバリアントを選択します:
    • 反復: npx hyperframes render --quality draft
    • 納品: npx hyperframes render --quality high --output out.mp4
    • CI / クロスホスト再現: npx hyperframes render --docker --strict --output out.mp4
    • クラウド(長時間/大規模): npx hyperframes lambda render ./my-project --width 1920 --height 1080 --wait(以下の Lambda を参照)

プレビューの前に lint、validate、inspect を実行してください。lint は、欠落した data-composition-id、重複トラック、未登録のタイムラインを検出します。validate はヘッドレス Chrome でコンポジションを読み込み、実行時コンソールエラーと WCAG コントラスト問題を報告します。inspect はタイムラインをシークし、吹き出し/コンテナからはみ出したりキャンバス外にはみ出したテキストを報告します。また、*.motion.json サイドカーが存在する場合は、同じシークされたタイムラインに対してモーションの意図(シーク時のエントランス発火、スタガー順序、フレーム内収まり、ライブネス)を検証します。

モーション量の多い作業では、スナップショット駆動の反復と *.motion.json サイドカーを優先してください。詳細な方法とモーション検証仕様については references/lint-validate-inspect.md を参照してください。

エージェント規約

すべてのコマンドに適用される横断的ルール:

  • --json は render、preview、play を除くすべてのコマンドで使用可能です。 サポート対象のコマンドに対するエージェント / CI 呼び出しで使用してください。出力には _meta エンベロープ(CLI バージョン、最新版、更新アドバイス)が含まれます。render は stdout と終了コードのみでステータスを報告するため、以下のレンダリング後チェックで成功を確認してください。preview / play はサーバーであるため JSON 出力はありません。
  • doctor --json は、環境に問題がある場合でも常に終了コード 0 で終了します。 ペイロードの ok フィールドで判定してください:npx hyperframes doctor --json | jq -e '.ok' > /dev/null。これにより、CLI のリリース変更からパイプラインを保護します。
  • 非 TTY モードは自動検出されます。 stdout が TTY でない場合(CI、エージェント、パイプ出力)、CLI は自動的に非対話モードに切り替わります。init の場合は --example が必要になります。TTY 上でも強制的にこのモードにするには --non-interactive を渡してください。
  • レンダリングの CI ゲート:--strict は lint エラーで失敗し、--strict-all は警告でも失敗し、--strict-variables は未宣言の --variables キーで失敗します。
  • --json 内のパスは秘匿化されます — $HOME はリテラル文字列 $HOME になるため、出力をバグ報告やエージェントコンテキストに安全に貼り付けることができます。
  • レンダリングはユーザー承認が必要です。 チェックが通ったら自動レンダリングは絶対に行わないでください。preview で一時停止し、ユーザーに Studio でビデオが編集可能であることを伝え、ユーザーの承認後にのみレンダリングしてください。
  • レンダリング後の検証。 render が終了コード 0 で戻った後、成功を報告する前に出力ファイルが存在し、妥当なサイズであることを確認してください:[ -s "$OUTPUT" ] || echo "render produced no output"。CLI は成功時に ◇ <パス> を出力します。長時間のレンダリングの場合は、ffprobe -i "$OUTPUT" -show_format -v error で長さも確認してください。

ルーティング

目的参照先
プロジェクトのスキャフォールド(init、capture、skills)references/init-and-scaffold.md
正確性のチェック(lint、validate、inspect、snapshot)references/lint-validate-inspect.md
プレビューまたはレンダリング(preview、play、render、publish)references/preview-render.md
環境の診断(doctor、browser)references/doctor-browser.md
AWS Lambda でのクラウドレンダリング(lambda deploy / sites / render / progress / destroy / policies)references/lambda.md
その他(info、upgrade、compositions、docs、benchmark、telemetry、アセット前処理)references/upgrade-info-misc.md

スキル間ハンドオフ

  • Tailwind プロジェクト(init --tailwind)→ クラスやテーマトークンを編集する前に hyperframes-core(Tailwind リファレンス)を使用します。
  • レジストリブロック/コンポーネント(hyperframes add、hyperframes catalog)→ インストールパス、サブコンポジションワイヤリング、スニペットマージについては hyperframes-registry を使用します。
  • アセット前処理(tts、transcribe、remove-background)→ 音声選択、Whisper モデルルール、キャプション、TTS→キャプションチェーンについては hyperframes-media を使用します。
  • パラメータ化レンダリング(--variables)→ <html> の data-composition-variables で宣言します。完全なスキーマは hyperframes-core を参照してください。

Lambda(クラウドレンダリング)

hyperframes lambda は分散レンダリングを AWS Lambda にデプロイし、ラップトップまたは CI からレンダリングを実行します。エンドツーエンドは 3 つのコマンドです:

npx hyperframes lambda deploy                                             # SAM スタックをプロビジョニング(Lambda + Step Functions + S3)
npx hyperframes lambda render ./my-project --width 1920 --height 1080 --wait
npx hyperframes lambda destroy                                            # 破棄(S3 バケットは保持)

レンダリングが 1 台のホストでは長すぎる/大きすぎる場合(数分以上の動画、4K、大規模並列バッチ)で、AWS 認証情報が設定されている場合に Lambda を使用します。開発ループの反復にはローカルの render を使用してください。

前提条件、6 つのサブコマンドすべて(deploy、sites create、render、progress、destroy、policies)、IAM ポリシーの検証、状態ファイル、コスト/クリーンアップルールについては references/lambda.md を参照してください。

最小完了ゲート

静的ゲート

npx hyperframes lint
npx hyperframes validate

レイアウトに依存する作業には inspect を追加し、CI では lint エラーで失敗させるために render --strict を追加してください。

視覚的スモークテスト — サブコンポジションを使用するプロジェクトでは必須

lint / validate / inspect は各コンポジションを単独で評価します。index.html をロードして data-composition-src を介してサブコンポジションをマウントすることは決してないため、クロスファイルのマウント障害をキャッチできません(hyperframes-core → references/sub-compositions.md、「よくある落とし穴」を参照)。これらをキャッチできる唯一のゲートは、実際に index.html をロードしてタイムラインをシークするものです。

hyperframes snapshot を使用してください。これは render と同じ方法でプロジェクトをロードするため(同じマウントパスを実行します)、要求されたタイムスタンプのみをキャプチャするため、フルレンダリングではなく数秒で完了します:

# 各サブコンポジションの中間点で 1 フレームをキャプチャ。
# 中間点 = index.html の各ホストスロットの data-start + data-duration/2。
npx hyperframes snapshot --at <t1>,<t2>,<t3>,...

# または、シーンごとのターゲティングが不要な場合の等間隔サンプル:
npx hyperframes snapshot --frames 9

出力は snapshots/frame-NN-at-Xs.png に保存されます。各フレームをシーンプランと目視比較してください。

フレームごとの注意信号(それぞれが静的ゲートでは見逃される特定の障害モードに対応):

見た目根本原因
テキストが左上隅に小さく、スタイルなしで表示される<style> ブロックが <template> の外、<head> 内に残っている(落とし穴 1)— CSS がライブ DOM に到達していない
SVG/アイコン要素がキャンバスサイズに拡大されている同上 — 幅/高さの制約が適用されていない
シーンのヒーロー要素が完全に欠落しており、背景とウォーターマークのみ表示されているホスト ID ≠ テンプレート ID(落とし穴 2)— タイムラインが実行されず、初期状態のフレームがキャプチャされた
スナップショットコマンドが Sub-composition timelines not registered after 45000ms とログ出力落とし穴 2 — 直接的な確認

snapshots/ は目視確認後に削除して構いません。ユーザー向けの最終レンダリングは、npx hyperframes render を使用した別のパスになります。

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-

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.

関連スキル