Communitygithub.com

1345AbhishekKumar/starter-supabase

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

starter-supabase とは?

HyperFrames Core は、HTML から動画をレンダリングするための中心的な技術契約です。このスキルは、単一の HyperFrames プロジェクトを構築するための完全なガイドを提供し、`data-*` 属性による DOM のタイミング宣言、シーク可能なアニメーションランタイム、フレームワークが所有するメディア再生の仕組みを定義します。このスキルは、Claude Code や Codex などの AI エージェントが、正しい合成 HTML を作成するために必要なすべてのルール(決定論的レンダリングの制約、アニメーション可能なプロパティの許可リスト、レイアウトの落とし穴など)を網羅しています。スタンドアロン構成とサブ構成の 2 つのルートフォームの違い、非交渉ルール(例:Math.random の禁止、無限ループの禁止)、そして `lint`/`validate`/`inspect` では検出できないサイレントバグ(例:ルート要素のサイズ未指定、v4 の Tailwind サポート)を強調しています。また、詳細な参考資料(例:データ属性、トラックとクリップ、サブ構成、変数とメディア)へのリンクも提供されており、開発者は具体的なニーズに応じて深く掘り下げることができます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-supabase/tree/HEAD/.agents/skills/hyperframes-core

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

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

ドキュメント

HyperFrames Core

HyperFrames は HTML から動画をレンダリングします。コンポジション(合成)とは、data-* 属性でタイミングを宣言する DOM を持ち、アニメーションランタイムがシーク可能で、メディア再生をフレームワークが所有する HTML ファイルです。

このスキルは 技術契約 — 1 つの hyperframes プロジェクトを構築する方法です。以下の本文はビルドガイドであり、トピックごとの詳細は 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 13 individual skills — each has its own dedicated page.

1345AbhishekKumar/starter-supabase

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

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`).

1345AbhishekKumar/starter-supabase

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`.

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

1345AbhishekKumar/starter-supabase

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

1345AbhishekKumar/starter-supabase

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

1345AbhishekKumar/starter-supabase

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

1345AbhishekKumar/starter-supabase

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /website-to-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

1345AbhishekKumar/starter-supabase

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

1345AbhishekKumar/starter-supabase

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.

関連スキル