Communitygithub.com

sansayan01/finance_app_zo

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

finance_app_zo とは?

このスキルはHyperFramesのコア技術契約であり、HTMLからビデオをレンダリングするための合成プロジェクトを構築するための完全なガイドです。`data-*`属性を使用してDOMのタイミングを宣言し、フレームワークがメディア再生を所有する構成について説明します。このスキルは、スタンドアロン合成とサブ合成の2つのルート形式、決定論的レンダリングルール(ランダム性や無限ループの禁止など)、アニメーション可能なプロパティの許可リスト、メディア配置ルールなど、開発者が知っておくべき必須ルールをカバーしています。また、Tailwind v4プロジェクトのサポート、STORYBOARD.md/SCRIPT.md計画形式にも対応しています。主な機能として、静かに失敗するバグの防止(例:ルート要素のサイズ設定、テンプレートの配置、IDの一意性など)や、既存の合成を編集する際のベストプラクティスが含まれ、`hyperframes-cli`ツールを使用したバリデーションとプレビューのコマンドも提供します。このスキルはClaude CodeやCodexを含むすべての主要なAIエージェントプラットフォームで動作するように設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sansayan01/finance_app_zo/tree/HEAD/.agents/skills/hyperframes-core

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

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

ドキュメント

HyperFrames コア

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

このスキルは 技術契約 です — 1つの HyperFrames プロジェクトを構築する方法です。以下の本文はビルドガイドであり、トピックごとの詳細は references/(次にインデックスあり)にあり、必要に応じて読んでください。その他の関心は、兄弟ドメインスキル — hyperframes-animation、hyperframes-creative、media-use、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/brief-contract.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。

ルートはサイズ指定が必要(静かなレイアウトバグ)

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

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

各コンポジションは ちょうど1つ の gsap.timeline({ paused: true }) を window.__timelines["<id>"] (キー = ルート data-composition-id)に登録する。これはページロード時に 同期的に 構築される。レンダリング期間 = ルート 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-hidden は、プレビュー と レンダリングの両方でその要素を非表示にし、その時間ウィンドウを上書きします。これは非破壊的/元に戻すことができ、Studioのタイムラインの目のアイコンで切り替えられます。
  • サブコンポジションを追加する場合:ホストを配線する前に、内部の data-composition-id を確認してください。

バリデーション

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

  • npx hyperframes check が成功する(lint、ランタイム、レイアウト、モーション、コントラストにわたって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.

sansayan01/finance_app_zo

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 36 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. Runs locally end-to-end (transcribes and mattes the subject itself, no API key). Requires hyperframes and a single-subject clip (multi-shot clips ar...

sansayan01/finance_app_zo

The fallback workflow for authoring or editing any custom HyperFrames composition at any length or format — longer / multi-scene pieces, brand and sizzle reels, montages, title cards, static loops, freeform builds. Use only when no specialized workflow fits the input; routing table at /hyperframes.

sansayan01/finance_app_zo

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

sansayan01/finance_app_zo

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, render, publish, cloud, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background (validate/inspect/layout are deprecated aliases covered by check), or when troubleshooting the HyperFrames build/render environment. Entry point for HeyGen-hosted cloud rendering (`hyperframes cloud render / list / get / delete`) and self-managed AWS Lambda rendering (`hyperframes lambda deploy / render / progress / destroy / policies / sites`).

sansayan01/finance_app_zo

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

sansayan01/finance_app_zo

Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

sansayan01/finance_app_zo

MicroFlow Pro - MFI Staff Portal built with Flutter & Supabase

関連スキル