Communitygithub.com

AlessandroFare/fluxychat

汎用ビデオワークフロー。専用ワークフローがない場合や、BRIEF.md で `flow: companion` が指定された場合に、長尺・複数シーン作品、ブランドリール、モンタージュ、静止ループ、タイトルカード、フッテージリミックス、自由形式の制作に対応します。

fluxychat とは?

このスキルは、HyperFrames フレームワーク上で汎用的なビデオ合成を実行するための総合的なワークフローです。専用ワークフローが存在しないクリエイティブプロジェクトや、BRIEF.md で `flow: companion` が設定された場合に自動的にルーティングされ、ユーザーが手動で選択する必要はありません。 主な機能として、メディアアセット(オーディオ、画像、アイコン、ロゴ、ナレーション、キャプションなど)の統合、Figma デザインからのアセット取り込み、BRIEF.md に基づくプロジェクト状態管理、ストーリーボードの作成とレビュー、複数シーンの構成とアセンブリ、モーション・アニメーション・トランジションの適用、そして最終プレビューとレンダリング承認までの一貫したパイプラインを提供します。 特に companion フローでは、AI がディレクターとして機能し、ユーザーとの対話的な共同制作を可能にします。初期段階で最も高度なデザイン案(シーンのアーク、デザインスペック、各シーンの動きの処理、トランジション、オーディオアイデンティティなど)を提示し、ユーザーがそれをトリミングしながら理想の作品を組み立てていく方式を採用しています。 コードエディタ(Cursor、Claude Code、Codex など)で使用可能で、HyperFrames CLI コマンド(`npx hyperframes`)やノードスクリプトを実行してプロジェクトの初期化、設定、メディア処理、パケットディスパッチなどを行います。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/AlessandroFare/fluxychat/tree/HEAD/.agents/skills/general-video

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

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

ドキュメント

汎用ビデオ

このワークフローに頼る前に、以下を実行してください:

npx hyperframes skills update general-video

成功した no-op はスキルが最新であることを意味します。メモリから続行する代わりに、更新の失敗を表面化してください。

1. クロスカッティングソースアダプターを適用する

  • メディア: オーディオ、画像、アイコン、ロゴ、音声、グレーディング、LUT、加工/エフェクト、キャプション、またはメディア操作が必要な場合は、/media-use をロードし、../media-use/references/resolve.md(解決、採用、再利用)および ../media-use/references/setup-providers.md(プロバイダー、認証)に従ってください。あいまいなフッテージフィードバックや名前付きスタイルは、編集前に ../media-use/references/media-treatments.md を使用します。サポートされているメディアエフェクトを CSS/SVG/不透明度で即興で作成しないでください。最初の認証済みプロバイダーアクションの前に、npx hyperframes auth status を実行し、その出力をそのまま中継してください。サインアウトしている場合は、../hyperframes-core/references/brief-contract.md のゲートを適用します:協調モードではサインインまたは明示的なオフライン選択を待ちます。自律モードではステータスを述べ、利用可能なオフラインプロバイダーを通じて続行します。必要な機能を満たせるオフラインプロバイダーがない場合は、ブロッカーを表面化してください。ローカル採用のみでは認証ゲートは必要ありません。
  • Figma: 入力が figma.com URL の場合は、最初に /figma を実行してください。そのエクスポートされたアセット、トークン、コンポーネント、またはストーリーボードフレームからビルドします。生の Figma コネクタ呼び出しは、SVG サニタイゼーション、メディア出所、ブランドトークンバインディングをスキップするため、使用しないでください。

これらのアダプターは、/hyperframes によって選択されたワークフローを変更しません。

2. プロジェクトの状態から開始する

最初に一致する行を適用してください。下位の状態行は評価しないでください:

状態アクション
特定の編集編集を行い、既存のプロジェクト決定を維持し、影響を受けるチェックを再実行してください。探索を再開しないでください。
BRIEF.md が存在するそれを読んでください。workflow が別のワークフローを指定し、flow が companion でない場合は、引き継いでください。ブリーフの質問はしないでください。
ブリーフはないが、hyperframes.json または STORYBOARD.md が存在するファイルと記録された設定から再開してください。既知の事実のみから BRIEF.md をバックフィルしてください。
新規作成/hyperframes とそのインテントレイヤーを実行してください。workflow: general-video または flow: companion の場合のみここに戻ってください。

新規プロジェクトの場合は、ブリーフからケバブケースのディレクトリ名を選び、ブリーフを書く前にスキャフォールディングしてください:

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video

次に、../hyperframes-core/references/brief-format.md を使用して、プロジェクトルートに BRIEF.md を書いてください。既存のプロジェクトでは、ルートは hyperframes.json を含むディレクトリです。ブリーフ形式で指定された、確認された設定に基づくフィールドのみを記録し、node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT> を使用します。推測されたデフォルトは決して記録しないでください。ここで <MEDIA_DIR> はインストールされた /media-use スキルディレクトリ、<PROJECT_ROOT> は hyperframes.json を含むディレクトリです。インテントレイヤーがレシピを採用した場合は、今すぐ node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name> で適用し、再度尋ねないでください。

3. 実行形状を解釈する

../hyperframes-core/references/brief-contract.md の正規用語のみを使用してください:

フィールド意味効果
flow誰が主導するかautomation:ルートを選択して実行。companion:会話の中で共同作成。
storyboardボードがレビュー表面かどうかyes:計画とスケッチのレビューを実行。no:ボードなしでビルド。
派生 modeチェックポイントゲートの動作方法ブリーフ契約に従ってください。ユーザーにモードの名前を尋ねないでください。

これらの状態の同義語を発明しないでください。進行中の「とにかくビルドして」というシグナルはインテントレイヤーによって処理され、flow: automation、storyboard: no として到着します。

  • flow: automation の場合:ルートを選択し、最初の進捗更新で1行で述べてください。
  • 特定の編集の場合:新しいルートを発明せずに編集を行ってください。

コンパニオンフロー

flow: companion の場合:

  • BRIEF.md を読み、受け入れられた ## Assets および ## Customizations をプロジェクト成果物と調整してください。まだ保留中の受け入れられた作業を完了し、完了済みの作業はそのままにし、受け入れられた機能を新規のものとして再度提供しないでください。
  • 請負業者ではなく、ディレクターとして到着してください。 コンパニオンを選択したユーザーは、関与と品質を選択したのです。正直な応答は、あなたが防御できる最小のものではなく、あなたがデザインできる最良のバージョンです。最初の計画は天井の処理です:ストーリーアーク(最も近いジャンルのレンズを借用 — メニュー § ジャンルレンズ)、デザインスペック、各シーンのモーション処理を名前で引用(§ 5の計画規律)、トランジション、オーディオアイデンティティ — 音楽とサウンドマーク、または意図的な沈黙 — ユーザーの素材を配置し、デザインされたオープンとクローズ。各レイヤーが何を追加するかを1行で述べてください。高価なもの(レンダリング時間、サインイン、課金)を名前を付けるときにフラグしてください。ユーザーは処理をトリミングします。承認ごとに組み立てる必要はありません。
  • 天井はツールボックスではなくコンセプトに属します。 すべてのレイヤーは、ブリーフのメッセージに役立たなければなりません。あらゆるビデオを同じように飾る処理は装飾です。クラフトは天井に上がります。コンテンツは要求されたものを超えて成長することはありません(§ 6)。
  • チェックポイント間では、../hyperframes/references/capability-menu.md は双方向に機能します。トリガーリストとして:ユーザーがその入力を言及したとき、またはビルドがそのニーズに達したときに、関連する機能を提供します。各パスのアップグレードチャネルとして:計画、スケッチ、またはビルドのチェックポイントは、ユーザーが見ている素材を指す1つまたは2つのトレースされたオファーを運ぶことがあります(「シーン3のスタットはカウントアップ処理を望んでいます」)。提供する前にそれを読んでください。完全なカタログをダンプしないでください。
  • ユーザーが機能を受け入れた後、その成果物を作成し、一致する BRIEF.md 本文セクションにすぐに決定を記録してください。ユーザーが明示的に変更した場合のみ、フロントマターフィールドを書き換え、確認された設定を記録してください。
  • 同じストーリーボード、バリデーション、最終プレビュー、およびレンダリング承認ゲートを維持してください。コンパニオンは誰が操縦するかを変えますが、品質が要求するものを変えるわけではありません。

4. 各ステージの前に必要な知識をロードする

これらの読み込みは、条件が一致する場合に必須です:

条件行動する前に読む
任意の構成 HTML またはシーンレイアウト/hyperframes-core;レイアウト契約については references/determinism-rules.md を使用
任意の重要な作成または視覚的処理/hyperframes-creative → references/house-style.md および references/video-composition.md
任意のモーション、アニメーション、またはシーン遷移/hyperframes-animation;そのルーティングに従って一致するルール、アダプター、ブループリント、または遷移リファレンスに進む
storyboard: yes../hyperframes-core/references/storyboard-format.md および ../hyperframes-core/references/review-loop.md
任意のメディアアセットまたは操作(ナレーション、BGM、SFX、キャプション、グレーディング、または変換を含む)/media-use;フレームワーク再生と配置については /hyperframes-core → references/variables-and-media.md も読む
複数シーンアセンブリ../hyperframes-core/references/production-loop.md
flow: companion、最初の計画の前/hyperframes-creative → references/story-spine.md および references/house-style.md;最も近いジャンルレンズと完全な ../hyperframes/references/capability-menu.md — 天井処理はこれらからデザインされ、記憶からではありません
コンパニオン機能のオファー、キャプチャ、ビートグリッド、生成ビデオ、マップ、公開、またはクロスワークフロー機能../hyperframes/references/capability-menu.md
デザインスペックが存在する場合、最終承認の前/hyperframes-creative → references/design-adherence.md

これらの読み込みを記憶に置き換えないでください。段階的な開示は、一致するリファレンスが実際にロードされた場合にのみコンテキストを節約します。

5. 構成を実行する

この依存関係順序を使用してください。入力がない場合のみ、ステージをスキップしてください。

  1. 計画。 ビューアのアーク、構造、リズム、および期間ドライバーを述べてください。短い単一シーンには1つのファイルを使用してください。3つ以上のハードシーンカットまたは再利用されるシーンにはサブ構成を使用してください。ナレーションアークについては /hyperframes-creative → references/story-spine.md、リズムについては references/beat-direction.md、構造については /hyperframes-core → references/composition-patterns.md を読んでください。オープンエンドの複数シーンブリーフの場合は、/hyperframes-creative → references/prompt-expansion.md を通じてプロンプトを拡張してください。複数シーンの計画は各シーンの形状を引用します:/hyperframes-animation → blueprints-index.md からのブループリントID(該当する場合)、またはいずれも該当しない場合は rules-index.md から構成する名前付きルール — モーション名はそれらのインデックスから取得され、決して発明されません。ストーリーの真実がどのシーンが存在するかを決定し、引用がそれらを飾ります。複数シーンの計画はディスパッチ成果物としても記録されます:STORYBOARD.md のシーンごとに1つの ## Frame N ブロック — status: outline、宣言された src:、ブループリント/ルールの引用、およびビートテキスト — storyboard: no の場合でも。ブロックはディスパッチ単位であり、ボードはレビュー表面にすぎません。

  2. 要求されたら計画をレビューする。 storyboard: yes の場合は、それらのブロックに対して共有レビューループを実行してください。storyboard: no の場合は、ボードを開かずに続行してください。計画の一時停止がとにかく発生した場合は、後で再度停止するのではなく、その一時停止にサブエージェント委任許可(ステップ4のディスパッチのためにコードエディタで必要)を折り込みます。

  3. 依存関係を解決する。 並行作業の前にレジストリブロックをインストールしてください。ユーザーアセットをステージングし、既存のメディアを採用し、ブリーフが必要とするものだけを解決してください。タイミングが期間を決定する場合は、オーディオを早期に開始してください。

  4. シーンをビルドする。 短い単一シーンの作品の場合、モーションを追加する前に、そのシーンを最も目立つ瞬間に実装してください(確認されたワイヤーフレームが存在する場合、その最終状態であり、再描画してはいけません)。次に、引用されたブループリントまたはルールからアニメーション化してください — モーションを書く前に完全なレシピ本文(/hyperframes-animation → blueprints/<id>.md、rules/<id>.md)を読んでください。

    ディスパッチは規模が大きい場合にのみ元が取れます。 パケットの作成と新しいワーカーコンテキストのウォームアップには、実際の数分とトークンがかかります:最大約6つの短いシーンのフィルムは、このコンテキストでインラインで、1シーンずつ順にビルドする方が高速です(測定値:5つの短いシーン ≈ インラインで9分 vs パケット化で約21分)。計画がそれを超える場合(より多くのシーン、または個別に重いシーン)にのみファンアウトし、その場合、各ワーカーに 2~3シーン を与え、1つのシーンではなく、すべてのワーカーを1つのウェーブで 生成してください(2番目のウェーブはウィンドウをほぼ倍にします)。ディスパッチ時:

    node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"

    ビルダーは、シーンごとに1つの境界パケットを .hyperframes/frame-packets/ の下に書き込みます(シーンの正確なストーリーボードブロック + ブループリント本文 + 引用されたすべてのルールレシピをインライン化)および _role.md(../hyperframes-core/references/frame-worker-role.md から)。パケットを書いた後:

    ls .hyperframes/frame-packets/
    

    各パケット *.md ファイルは 1 つの worker-sub-agent に供給されます。worker-sub-agent はルール ../hyperframes-core/references/frame-worker-role.md に従い、パケット内の指示のみを使用し、worker を再帰的にファンアウトせず、worker 間の会話に参加せず、出力 HTML を .hyperframes/frame-packets/ に書き込み、_done シグナルを発行します。

    マスターエージェントは、すべてのパケットが完了するのを1分ごとに確認し(指定がない限り)、各完了後にそのシーンの STORYBOARD.md ブロックを status: built に更新し、## フレーム N ブロック全体をプロジェクトの storyboard.html に追加します。すべてのシーンがビルドされたら、それらをアセンブルし、フレーム間の遷移をレンダリングして一貫性のある構成にします。

  5. 検証する。 アセンブルされた構成に対して検証を実行してください:/hyperframes-core → references/determinism-rules.md のレイアウトコントラクト、/hyperframes-creative → references/house-style.md と references/video-composition.md のスタイルと構成ルール、および /hyperframes-creative → references/design-adherence.md のデザイン遵守(デザインスペックが存在する場合)。エラーは修正し、修正が他のシーンに影響する場合は、影響を受けるシーンを再ビルドし、再アセンブルし、再検証してください。

  6. 最終プレビューを提供する。 フル作品プレビューを含む最終更新をユーザーに送信してください。flow: automation の場合:プレビューを送信し、render コマンドを実行してから完了を宣言してください。flow: companion の場合:storyboard: yes の場合は最終レビューゲート、storyboard: no の場合はレンダリング承認ゲートを実行してください。

  7. レンダリングして完了する。 承認されたら、`npx hyperframes render

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

AlessandroFare/fluxychat

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.\n

AlessandroFare/fluxychat

Use when audio already placed in a HyperFrames composition needs to be mixed: a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.\n

AlessandroFare/fluxychat

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.\n

AlessandroFare/fluxychat

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

AlessandroFare/fluxychat

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.\n

AlessandroFare/fluxychat

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

AlessandroFare/fluxychat

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

AlessandroFare/fluxychat

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

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. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

AlessandroFare/fluxychat

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

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

AlessandroFare/fluxychat

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

AlessandroFare/fluxychat

Design and improve user interfaces using the concrete rules from Refactoring UI (Wathan & Schoger) — constrained spacing/type/color/shadow scales, visual hierarchy through weight and color rather than size, and depth through emulated light. Use when building or styling any UI (web, app, dashboard, landing page, component), when picking font sizes, spacing, colors, shadows or border radius, when designing a color palette or design tokens, and whenever someone says a UI "looks off", "looks amateur", "feels cluttered/plain/unfinished", or asks to "make this look better".

AlessandroFare/fluxychat

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

AlessandroFare/fluxychat

Use before UI-related work to select the smallest useful UI Skills context through the ui-skills CLI.

関連スキル