Communitygithub.com

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

HyperFrames 合成コントラクト — レンダリング可能なプロジェクトを1つ構築します。合成構造、`data-*` タイミング属性、`class="clip"`、トラック、サブ合成、変数、フレームワーク所有のメディア再生、決定論的レンダリングルール、バリデーションに使用します。合成HTMLを作成する前にお読みください。

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

このスキルは HyperFrames のコア仕様を定義するものです。HyperFrames は HTML からビデオをレンダリングするフレームワークで、合成(composition)は DOM 要素に `data-*` 属性でタイミングを宣言し、アニメーションランタイムがシーク可能で、メディア再生をフレームワークが管理する HTML ファイルです。このスキルは、開発者が HyperFrames プロジェクトを構築するための**技術契約**として機能します。具体的には、ルートフォーム(スタンドアロン vs サブ合成)の選択、`data-*` 属性や `class="clip"` を用いたクリップの配置、トラックと Z インデックスの管理、サブ合成の配線、変数とメディア再生の設定、決定論的レンダリングのための禁止事項(ランタイムクロック、未シード乱数、無限 repeat など)の遵守、そして CLI ツール(lint, validate, inspect, snapshot, preview, render)によるバリデーション手順をカバーします。このスキルは、Claude Code、Cursor、Codex などの AI エージェントが HyperFrames の合成を正しく生成・編集するためのガイドとして設計されています。

対応~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-core

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

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

ドキュメント

HyperFrames コア

HyperFrames は HTML からビデオをレンダリングします。合成(composition)は、DOM が data-* 属性でタイミングを宣言し、アニメーションランタイムがシーク可能で、メディア再生がフレームワークによって管理される HTML ファイルです。

このスキルは 技術契約 — HyperFrames プロジェクトを1つ構築する方法を定義します。以下の本文はビルドガイドです。トピックごとの詳細は references/ にあります(次のインデックスを参照)。必要に応じてオンデマンドでお読みください。その他の関心事は、兄弟ドメインスキル — hyperframes-animation、hyperframes-creative、hyperframes-media、hyperframes-cli、hyperframes-registry — にあります。機能マップは /hyperframes にあり、各スキルがカバーする内容を示しています。

リファレンス

ファイル読む目的
references/minimal-composition.md最小のレンダリング可能な合成スケルトンから始める
references/composition-patterns.mdモノリシック vs モジュラーを選択する。モジュラーな index.html を構成する。サブ合成アーキタイプを選ぶ
references/data-attributes.md任意の data-* (ルート/クリップ/サブ合成ホスト/レガシーエイリアス) を調べる。class="clip" を使用する
references/tracks-and-clips.mddata-track-index を選ぶ。同じトラックの重なり/z-indexを処理する。別のクリップを基準にクリップのタイミングを設定する
references/sub-compositions.mdサブ合成を配線する(ホスト属性、<template>、インスタンスごとの変数)。その内部でアニメーションさせる
references/variables-and-media.md変数を宣言する。<video>/<audio> を配置する。音量を設定する。トリミングする
references/determinism-rules.mdシーク可能なタイムラインを構築する。決定論の禁止事項。アニメーション可能プロパティの許可リスト。レイアウト/テキストフィット
references/full-screen-motion.md共有背景を使用して全画面モーションを作成する
references/storyboard-format.mdSTORYBOARD.md 計画を作成する(解析済みマニフェストを含む)
references/script-format.mdオプションのロックされたナレーション SCRIPT.md を作成する
references/subagent-dispatch.mdサブエージェントディスパッチ動詞(並列ファンアウト/バックグラウンド/待機)をハーネスにマッピングする
references/tailwind.mdTailwind v4 プロジェクトで作業する(init --tailwind。ランタイム契約は Studio の v3 とは異なる)

アニメーションランタイム固有の詳細(GSAP API、Lottie、Three.js など)については、hyperframes-animation → adapters/<runtime>.md を参照してください。

合成の構築

2つのルート形式(互換性なし)

  • スタンドアロン(トップレベルの index.html) — ルート <div data-composition-id="…"> は <body> 内に直接配置されます。<template> ラッパーは不要(ラップするとすべてのコンテンツが非表示になり、レンダリングが壊れます)。
  • サブ合成(data-composition-src 経由で読み込まれる) — ルートは <template> でラップする必要があります。

⚠ トランスポートルール: ランタイムは <template> の内容のみをクローンします。テンプレート外のすべて(<head> スタイル/スクリプトを含む)は破棄されます — <style>/<script> はテンプレート内部に配置してください。 ⚠ ホストIDルール: ホストスロットの data-composition-id は、内部テンプレートの data-composition-id および window.__timelines["<id>"] キーと完全に一致する必要があります — -mount/-slot/-host サフィックスは使用しないでください。

ファイルの形状、ホストの配線、レンダリング前チェックリスト → references/sub-compositions.md。

ルートはサイズ指定必須(サイレントレイアウトバグ)

スタンドアロンルートは明示的なサイズ指定されたボックス(px 単位の width/height)が必要です。また、height:100% の要素までのすべての祖先は、解決された高さを持っている必要があります。そうしないと、flex または 100% の子要素が約 0 に崩れ、コンテンツが左上隅に積み重なります。lint/validate/inspect はこれをキャッチしません。スケルトン → references/minimal-composition.md。

1つの一時停止タイムライン

各合成は、ページ読み込み時に同期的に構築された、window.__timelines["<id>"](キー = ルートの data-composition-id)に正確に1つの gsap.timeline({ paused: true }) を登録します。レンダリング時間はルートの data-duration であり、タイムラインの長さではありません。手動でサブタイムラインをホストにネストしないでください。完全な契約(GSAP 以外のランタイムを含む) → references/determinism-rules.md + hyperframes-animation/adapters/。

譲れないルール(lint/validate/inspect がキャッチしないサイレントバグ)

ここに記載。完全な根拠はリンク先のリファレンスを参照。違反しないでください:

  • レンダリングタイムクロック / 未シードの Math.random / ネットワーク / 入力状態は禁止。repeat: -1 は禁止(有限カウントを使用)。 → determinism-rules.md
  • ビジュアルプロパティ許可リストのみアニメーション可能。display/visibility は禁止。後続シーンのクリップに gsap.set は禁止。 → determinism-rules.md
  • 本文テキストに <br> は禁止。変形された要素はブロックレベルでサイズ指定が必要。パルスする絶対配置装飾にはピーククリアランスが必要。 → determinism-rules.md
  • <video>/<audio> はホストルートの直接の子でなければならない(サブ合成の <template>/ラッパー内部には絶対に配置しない)。フレームワークが再生を所有する。 → variables-and-media.md
  • すべての id はアセンブルされたページ全体で一意でなければならない。サブ合成内では、ID に合成IDをプレフィックスとして付ける(#<id>-hero)。重複する <video>/<img> の ID は空白をレンダリングする — プロデューサーは getElementById でフレームを注入し、ファイル間の重複は lint をすり抜ける。 → composition-patterns.md
  • 全画面シーンの塗りつぶしは、全面にあふれる子要素(position:absolute; inset:0)に配置する。合成ルート自体には絶対に配置しない — プロデューサーのフレーム合成はルート要素自体の background をドロップする可能性がある(フレームは黒くレンダリングされる)。プレビュー/snapshot では正しく表示されていても。 → composition-patterns.md

既存の合成の編集

  • 最初にファイルを読んでください。関連のないタイミング、トラック、ID、変数、メディアパスは保持してください。
  • 既存の合成 ID とタイムラインキーに一致させてください。
  • クリップの追加: 重複しない data-track-index を選ぶか、周囲のタイミングを意図的に調整してください。
  • サブ合成の追加: ホストを配線する前に、内部の data-composition-id を確認してください。

バリデーション

コマンドの詳細については hyperframes-cli を使用してください

  • npx hyperframes lint がパスする(エラー0)
  • npx hyperframes validate がパスする(コンソールエラー0)
  • npx hyperframes inspect がパスする(エラー0)
  • サブ合成を含むプロジェクト: npx hyperframes snapshot --at <midpoints> で各フレームを目視確認
  • npx hyperframes preview でレビュー(ユーザーは Studio のタイムラインで任意に編集可能)
  • 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-

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-

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.

関連スキル