Communitygithub.com

AlessandroFare/fluxychat

短くデザイン主導のモーショングラフィック — 運動そのものがメッセージとなるキネティックタイポグラフィ、統計カウントアップ、チャート/データビジュアライゼーション、ロゴスティング/ブランドロックアップ、ローワーサード/コールアウト/ソーシャルオーバーレイ、アニメーションマップ(地域ハイライト、場所の接続、地点へのズーム)、アニメーションツイート/ニュース記事/ヘッドライン、ウェブページ/UIアニメーション(スクロール、カーソル、コールアウト)、または実画像の形状をチャートに融合。通常10秒未満(最大約30秒)、ナレーションや実写被写体なし。MP4または透過オーバーレイでレンダリング。長尺/ナレーション/マルチシーン -> /general-video。不明 -> /hyperframes。

fluxychat とは?

このスキルは、短くデザイン主導のモーショングラフィック(通常10秒未満、最大30秒程度)を作成するためのものです。ナレーションや実写被写体はなく、動きそのものがメッセージとなります。キネティックタイポグラフィ、統計のカウントアップ、データビジュアライゼーション、ロゴアニメーション、ローワーサード、ソーシャルメディアオーバーレイ、アニメーションマップ、ツイートやニュース記事のアニメーション、ウェブページやUIのアニメーション(スクロール、カーソル、コールアウト)、実画像の幾何学的形状をチャートに変換するアセットフュージョンなど、さまざまなカテゴリをサポートします。MP4または透明なオーバーレイとしてレンダリングされます。このスキルは、Claude Code、Cursor、CodexなどのAIエージェント向けに設計されており、完全自律型のワークフローを提供します。まずアセット戦略を決定し、実際の素材をソースしてからショットをデザインし、カタログ機能を再利用してコンポジションを構築します。すべてのアーティファクトは `videos/<project-name>/` ディレクトリに保存され、計画、ソース、デザイン、ビルド、検証、承認、レンダリングの各フェーズを通じてプロジェクトが進行します。

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

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

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

ドキュメント

まず、このスキルを常に最新に保ってください — 静かに実行し、尋ねないでください: npx hyperframes skills update motion-graphics。すべてが最新の場合は高速なno-opです。そうでなければ、このスキルと、それが依存するコアドメインスキルを、それらに依存する前に更新します。

figma ソース: ロゴ/アセット/アニメーションをビルドする元がfigma.comのURLからの場合は、最初に/figmaを実行してください — アセットエクスポート、ブランドトークン、およびグラフィックがFigma Motionのインポートである場合のMotion→GSAP変換を行い、その出力からビルドします。生のMCPツールで直接Figmaを操作しないでください。SVGサニタイゼーション、.media/manifest.jsonlの来歴、ブランドトークンのvar()バインディングをスキップするため、後でブランドの変更があった場合に完全な再インポートなしでは変更が伝播しません。

motion-graphics — ディスパッチエントリ

正面玄関は/hyperframesです。 このスキルは、短く、デザイン主導で、ナレーションのないモーショングラフィック(動きがメッセージ。約10秒未満、ボイスオーバーなし)を作成します。それより長いもの、ナレーション付き、またはマルチシーン — または不確かな場合 — は、最初に/hyperframesを読んでください。インテントレイヤーがすべてのルート決定を担当します。

このワークフローは設計上自律的です — 最大で1つの確認質問(agents/director.md)、その後は中間レビューなしで検証までビルドします。インテントレイヤー(/hyperframes → references/intent-interview.md)は、ランシェイプの質問なしでここに直接ルーティングします。このような短い作品にストーリーボードやコンパニオンセッションを追加することはほとんどありません。レンダリングは依然としてユーザーゲートです。チェックとプルーフスナップショットが合格した後、../hyperframes-core/references/brief-contract.mdから標準的な「プレビューか、レンダリングか?」の質問をしてください。BRIEF.mdが存在する場合は、ディレクターの質問の前にそれを読んでください。

短いデザイン主導のモーショングラフィック。アセットファースト: ショットをデザインする前にアセット戦略を決定し実際の素材を入手し、それから入手したものに基づいてショットをデザインし、カタログ機能を再利用してコンポジションを行います。すべてのアーティファクトはPROJECT_DIR = videos/<project-name>/(ステップ0で作成)に保存されます。以下のすべてのパスはそれに対する相対パスです。

フェーズ実行主要なアーティファクト詳細フロー
初期化Bashhyperframes.jsonステップ0
計画サブエージェント — 検索を決定? + 分類 + アセット戦略shot-plan.json(ドラフト: カテゴリ, asset_needs クエリ, ブリーフ)agents/director.md(パート1)
ソース ◇Bash — media-use resolve(asset_needsが空の場合はスキップ)assets/ + assets/index.mdphases/source/guide.md
デザインサブエージェント — 解決されたアセットを中心にショットをデザインshot-plan.json(最終: ブロック + レイアウト + モーション + 位置)agents/director.md(パート2)
ビルドサブエージェント — 再利用ファーストのコンポジションcompositions/index.htmlagents/builder.md
検証Bash — lint、check、プルーフスナップショット; 失敗時は修復snapshots/contact-sheet.jpgステップ5
承認プレビューまたはレンダリングを尋ねる; 回答を待つ明示的なレンダリング承認ステップ6
レンダリングBash — hyperframes render(MP4、またはオーバーレイ用--format webm/mov)renders/video.mp4 または透明なオーバーレイステップ6

◇ ソースは、選択されたカテゴリがアセットを宣言している場合にのみ実行されます。純粋なコード/テキストカテゴリ(例:kinetic-type、ほとんどのcharts/stat)はasset_needs: []を持ち、計画から直接デザインにスキップします。

カテゴリ — 検索判断で分割

planの最初の判断は: これに検索が必要か? この分岐でカテゴリは2つのグループに分かれます。その後、具体的なカテゴリが選択されます — 検索駆動の場合は、検索が返すコンテンツのタイプによって。各カテゴリは1つのcategories/<id>/module.md(計画とビルドルール)です。共有のモーションボキャブラリはreferences/motion-vocabulary.md(→ hyperframes-animationルール/ブループリント + レジストリブロック)にあります。

フォームカテゴリ — 検索なし。ユーザーがコンテンツを提供:

カテゴリインテント依存元
kinetic-typeパンチの効いた行/引用/タイトル、モーションファーストのテキストcaption-* ブロック + アニメーションルール
stat1つのヒーロー数字/カウントアップ + リングapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsデータからの棒/線/円/レース/パーセンテージdata-chart ブロック
logo-revealロゴスティング / ブランドロックアップ(ユーザーロゴ)logo-outro / rules/svg-path-draw
lower-thirds名前/タイトルバー、コールアウト、ソーシャルオーバーレイcaption-* + レジストリオーバーレイブロック
maps地理的な動き — 地域のハイライト、場所の接続、場所へのズーム(ベクターレーン、またはベイクドベースマップレーン)us-map / world-map ファミリー + bake-basemap.mjs

検索駆動カテゴリ — 最初に検索し、次にコンテンツタイプでアニメーション化(RWAパス):

返されるコンテンツカテゴリアニメーション
ウェブページ/リンクwebpageウェブページ/UIアニメーション(スクロール、リビール、カーソル、コールアウト)
ニュース記事newsヘッドラインリビール + ソースカード + キーファクトコールアウト
ツイートtweetアニメーションツイートカード
画像/エンティティasset-fusionアセットの形状が_チャートになる_(RWAダイジェティックフュージョン)

ビルド順序: 一度に1つ、カバレッジファースト(ラフで問題ありません)。kinetic-typeはプロトタイプから移植。残りはそれに従います。

前提条件

macOS Apple Silicon または Linux x64。システムツール: brew install node ffmpeg。npx hyperframes doctorを1回実行。macOS GPUレンダリング: export PRODUCER_BROWSER_GPU_MODE=hardware。

オプションのキー(未設定の場合はローカルフォールバック) — media-useを介してアセットをソース/生成するカテゴリでのみ必要:

キー使用目的フォールバック
GEMINI_API_KEY / GOOGLE_API_KEY画像生成(media-use resolve)生成をスキップ / 検索のみ
(asset_scout / 検索プロバイダ)webpage/news/tweet + asset-fusion 実アセット検索カテゴリはアセットフリーに劣化

フロー

ステップ 0 — 初期化

cwdはエージェントのワークスペースルートです。すべてのアーティファクトをPROJECT_DIR = videos/<project-name>/の下に書き込みます。<project-name>: ユーザーが指定したディレクトリを使用するか、そうでなければインテントから短いケバブケース名を使用します(<subject>-motion)。ワークスペースのベースネームやタイムスタンプは使用しません。

$PROJECT_DIR/hyperframes.jsonが存在しない場合のみ:

PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=motion-graphics

initはインストールされているスキルをGitHub上の最新版と照合し、古いものがあればグローバルセットを更新します。

制約: ワークスペースルートでhyperframes initを決して行わないでください。PROJECT_DIR内に別のhyperframes/をネストしないでください。すべてのBashコマンド(マスター + サブエージェント)は(cd "$PROJECT_DIR" && ...)サブシェルです — 裸のcdは絶対に使用しないでください。

ステップ 1 — 計画(サブエージェント: Director パート1)

1つのサブエージェントをディスパッチします。プロンプト = agents/director.md全文 + ## Dispatch context(SKILL_DIR / PROJECT_DIR / ユーザーのリクエスト / Schema: <SKILL_DIR>/references/shot-plan-ir.md)。以下のことを行う必要があります:

  1. 判断: これに検索が必要か?(最初の分岐)
    • いいえ → フォームカテゴリを選択(kinetic-type / stat / charts / logo-reveal / lower-thirds); コンテンツはユーザー提供; asset_needs: []。
    • はい → 検索計画をasset_needs[]に出力(news / web / tweet / image; 2極クエリ)。具体的な検索駆動カテゴリ(webpage / news / tweet / asset-fusion)はステップ2で返されるコンテンツタイプによって確認され、ステップ3で最終決定されます。
  2. ドラフトshot-plan.jsonを書き込みます(エンベロープ + 選択されたフォームカテゴリ または 検索インテント + asset_needs + 1段落のショットブリーフ)。スキーマ: references/shot-plan-ir.md。

検証: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing。

ステップ 2 — ソース ◇(Bash: media-use、条件付き)

shot-plan.json.asset_needsが空でない場合、アセットを解決します(検索/生成/フェッチ → フリーズされたプロジェクトローカルパス + 台帳)。phases/source/guide.md(media-use resolveをラップ; 検索駆動カテゴリはnews/web/tweet/image検索を使用)を参照してください。asset_needsが空の場合は、ステップ3にスキップします。

# 例示 — phases/source/guide.mdを参照
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)

グレースフルに劣化: 検索/プロバイダが利用できない場合、カテゴリはアセットフリーにフォールバックします(context.logにその旨を記録)。

ステップ 3 — デザイン(サブエージェント: Director パート2)

サブエージェントをディスパッチします(プロンプト = agents/director.md パート2 + ステップ2が実行された場合は解決されたassets/index.mdを含むディスパッチコンテキスト + catalog-map.md)。利用可能なアセットを中心にショットをデザインします: カタログブロック + hyperframes-animationルール/ブループリント、レイアウト、モーション、ビート、そして(asset-fusionの場合は)element_positions + スポイトパレットを選択します。shot-plan.jsonを最終決定します(content.block + content.customize + カテゴリごとのコンテンツ)。

ステップ 4 — ビルド(サブエージェント: Builder、再利用ファースト)

サブエージェントをディスパッチします。プロンプト = agents/builder.md全文 + ディスパッチコンテキスト(shot-plan.json、catalog-map.md、カテゴリのmodule.md、references/motion-vocabulary.md、references/builder-contract.md)。再利用ファースト: npx hyperframes add <block> + その場でカスタマイズ; ギャップとアセットフュージョンのアフォーダンスのみを手動で作成します。HFコントラクトに従ってcompositions/index.htmlを出力します(一時停止されたGSAPタイムラインをwindow.__timelinesに、class="clip" + 安定したID、tl.seek(0)、決定論的)。

ステップ 5 — 検証(Bash → 失敗時に修復サブエージェント)

(cd "$PROJECT_DIR" && npx hyperframes lint .)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-times>)

開始状態、シグネチャームーブ、最終ホールドを示すプルーフタイムを選択します。続行する前に、生成されたコンタクトシートまたはスナップショットシートを検査します。lint、check、またはスナップショットの失敗時には、修復サブエージェント(agents/finalize.md)を1回のインプレース修正パスのためにディスパッチし、失敗したゲートを再実行します。欠陥を隠すためだけに固定の持続時間を変更しないでください。

ステップ 6 — 承認とレンダリング(Bash)

1つの質問をします: 「プレビューを先に、それともレンダリングしますか?」ユーザーがプレビューを選択した場合、Studioを開き、修正後に同じ承認ゲートに戻ります:

(cd "$PROJECT_DIR" && npx hyperframes preview)

明示的なレンダリングの回答があった場合のみレンダリング:

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q high -o ./renders/video.mp4)
# 透明オーバーレイのバリアント: --format webm  (または mov)

出力が存在し、空でなく、意図した持続時間であることを確認します。最終的なハンドオフは、アーティファクト名、実際の持続時間、コンポジションまたはフレームID、プルーフタイム、および検査されたコンタクトシートまたはスナップショットシートに名前を付けます。フラグは/hyperframes-cli → references/preview-render.mdにあります。

再開テーブル

状態続行する場所
shot-plan.json なしステップ1(計画)
shot-plan.json に asset_needs があるが、assets/ なしステップ2(ソース)
shot-plan.json 最終版、compositions/index.html なしステップ3/4(デザイン+ビルド)
compositions/index.html が存在するが、プルーフスナップショットなしステップ5(検証)
チェックとプルーフスナップショット合格、承認されたレンダリングなしステップ6(承認)
承認されたレンダリングが存在する出力を検証し、報告

デザインノート(メンテナー向け — 実行はこれを読みません)

  • アセットファーストの根拠: ソーシングはフロントロードされ、ショットデザインに情報を提供します(RWAフロー: 分析 → 検索 → レビュー → コンポーズ)。検索駆動カテゴリ(webpage/news/tweet)とasset-fusionはどちらもmedia-use検索(news/web/tweet/image)に依存しており、これはmedia-useの文書化されたRWAの流れです。
  • 再利用ファースト: エコシステム内でのLLM生成テンプレートの類似物は、"compose"することです

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

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

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

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.

関連スキル