Communitygithub.com

モーション・グラフィックス — ディスパッチエントリ

ユーザーが、モーションそのものがメッセージとなる短いデザイン主導のモーショングラフィックを求める場合に使用します。キネティックタイポグラフィ、数字のカウントアップ、チャート/データ可視化、ロゴスティング、ブランドロックアップ、ローワーサード、コールアウト、ソーシャルオーバーレイ、アニメーション化された見出し/ツイート/ニュース、モーションポスター、またはクイックキャプチャページハイライトなどです。通常10秒未満、最大約30秒で、ナレーション構成、ボイスオーバー、実写被写体はありません。MP4または透過オーバーレイにレンダリングできます。より長い、マルチシーン、ナレーション付き、またはブランドリール作品(general-videoを使用)、ナレーション付きウェブサイト動画(website-to-video)、トピック解説動画(faceless-explainer)、製品プロモーション(product-launch-video)、PR動画(pr-to-video)、または既存映像へのキャプション追加(embedded-captions)には使用しません。これがクイックモーションファースト作品か、より長い/ナレーション付き作品かわからない場合は、/hyperframesを参照してください。

モーション・グラフィックス — ディスパッチエントリ とは?

このスキルは、Claude CodeやCursorなどのAIエージェント向けに設計された、短時間のデザイン主導モーショングラフィック制作パイプラインです。主に10秒未満、最大30秒程度の、ナレーションやボイスオーバーを伴わない動画を生成します。キネティックタイポグラフィ、数値カウントアップ、チャート/データ可視化、ロゴリビール、ローワーサード、ソーシャルメディアオーバーレイ、ウェブページハイライトなど、多様なカテゴリをサポートします。 このスキルの大きな特徴は、**アセットファースト**のアプローチです。まずアセット戦略を決定し、実際の素材を調達してからショットをデザインすることで、効率的で現実的な動画制作を実現します。また、**再利用ファースト**の原則に従い、既存のカタログブロックやモーションルールを優先的に活用しながら、不足部分のみを手動で作成します。 ワークフローは、初期化(Step 0)、計画(Step 1)、ソース(Step 2)、デザイン(Step 3)、ビルド(Step 4)、レンダリング(Step 5)、検証(Step 6)の7ステップで構成され、各ステップはサブエージェント(Director、Builder、Finalize)が担当します。計画フェーズでは、まず検索が必要かどうかを判断し、フォームカテゴリ(検索不要)と検索駆動カテゴリ(Webページ、ニュース、ツイートなど)に分岐します。 対応プラットフォームはmacOS Apple SiliconまたはLinux x64で、Node.js、ffmpeg、およびhyperframes CLIツールが必要です。出力はMP4ファイル、または透過オーバーレイ用のWebM/MOV形式が可能です。このスキルは、長編動画、ナレーション付き動画、製品プロモーション、キャプション追加など他の動画制作スキルとは明確に区別されており、短くデザイン重視のモーショングラフィックに特化しています。

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

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

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

ドキュメント

モーション・グラフィックス — ディスパッチエントリ は何をしますか?

ルート確認はStep 0の前に行ってください。 このスキルは短い、デザイン主導の、ナレーションなしのモーショングラフィック(モーションがメッセージであり、約10秒未満、ボイスオーバーなし)を制作します。より長い、マルチシーン、またはナレーション付きの作品 → /general-video。ウェブサイトのナレーション付き動画 → /website-to-video。トピック解説 → /faceless-explainer。製品プロモーション → /product-launch-video。既存映像へのキャプション追加 → /embedded-captions。対象外: ライブ/レンダリング時データ、またはキャプチャできない映像。モーションファーストかナレーション付きか不明な場合? 最初に**/hyperframes を読んでください。**

短いデザイン主導のモーショングラフィックです。アセットファースト: ショットをデザインする前にアセット戦略を決定し、実際の素材を調達し、その素材を中心にショットをデザインし、カタログ機能を再利用して構成します。すべてのアーティファクトは PROJECT_DIR = videos/<project-name>/ に保存されます(Step 0で作成)。以下のパスはすべてこのディレクトリを基準とします。

フェーズ実行方法主なアーティファクト詳細フロー
initBashhyperframes.jsonStep 0
planサブエージェント — 検索を決定? + 分類 + アセット戦略shot-plan.json (ドラフト: カテゴリ、asset_needs クエリ、概要)agents/director.md (パート1)
source ◇Bash — media-use解決 (asset_needs が空の場合はスキップ)assets/ + assets/index.mdphases/source/guide.md
designサブエージェント — 解決済みアセットを中心にショットデザインshot-plan.json (最終版: ブロック + レイアウト + モーション + 位置)agents/director.md (パート2)
buildサブエージェント — 再利用ファースト構成compositions/index.htmlagents/builder.md
renderBash — hyperframes render (MP4、またはオーバーレイ用 --format webm/mov)renders/video.mp4Step 5
verifyBash — lint / inspect -> 失敗時は修復サブエージェント(修正はその場で)agents/finalize.md

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

カテゴリ — 検索判断による分割

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

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

カテゴリ意図依存先
kinetic-typeインパクトのある一行/引用/タイトル、モーションファーストテキストcaption-* ブロック + アニメーションルール
stat単一のヒーローナンバー/カウントアップ + リング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-* + レジストリオーバーレイブロック

検索駆動カテゴリ — 検索後、コンテンツタイプに応じてアニメーション(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解決)生成をスキップ / 検索のみ
(asset_scout / 検索プロバイダ)webpage/news/tweet + asset-fusion 実アセット検索カテゴリはアセットなしに劣化

フロー

Step 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

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

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

Step 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[] に出力(ニュース/ウェブ/ツイート/画像; 二極クエリ)。具体的な検索駆動カテゴリ(webpage / news / tweet / asset-fusion)は、Step 2で返されるコンテンツタイプによって確定し、Step 3で最終決定されます。
  2. ドラフト shot-plan.json を書き込みます(エンベロープ + 選択されたフォームカテゴリ または 検索意図 + asset_needs + 1段落のショット概要)。スキーマ: references/shot-plan-ir.md。

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

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

shot-plan.json の asset_needs が空でない場合、アセットを解決します(検索/生成/取得 → プロジェクトローカルパス + 台帳に確定)。phases/source/guide.md を参照(media-use resolve をラップ; 検索駆動カテゴリはニュース/ウェブ/ツイート/画像検索を使用)。asset_needs が空の場合は、Step 3 にスキップします。

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

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

Step 3 — デザイン(サブエージェント: Director パート2)

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

Step 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)、決定論的)。

Step 5 — レンダリング(Bash)

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

Step 6 — 検証(Bash → 失敗時は修復サブエージェント)

(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)

exit 0 → 完了。lint/inspect エラーが発生した場合、修復サブエージェント(agents/finalize.md: スナップショットQA + 1回のその場修正パス + 再レンダリング)を起動します。修復中に固定された期間を変更しないでください。

レポート + オプションプレビュー

最終出力(renders/video.mp4、または .webm / .mov オーバーレイバリアント)と期間を報告します。実行中はプレビューを開かないでください。 リクエストがあった場合のみ、レンダリング後に開始して最終ファイルを提供します:

(cd "$PROJECT_DIR" && npx hyperframes preview)   # Studio UI; または `npx hyperframes play` で共有リンク

フラグは hyperframes-cli スキール(references/preview-render.md)にあります。

再開テーブル

状態再開ポイント
shot-plan.json なしStep 1 (計画)
shot-plan.json に asset_needs あり、assets/ なしStep 2 (ソース)
shot-plan.json 最終版、compositions/index.html なしStep 3/4 (デザイン+ビルド)
compositions/index.html 存在、renders/video.mp4 なしStep 5 (レンダリング) + Step 6
renders/video.mp4 存在レポート + 停止

設計ノート(メンテナ — 実行時はこれを読みません)

  • アセットファーストの根拠: ソーシングは先行して行われ、ショットデザインに情報を提供します(RWAフロー: 分析 → 検索 → レビュー → 構成)。検索駆動カテゴリ(webpage/news/tweet)と asset-fusion はどちらもmedia-use検索(ニュース/ウェブ/ツイート/画像)に依存しており、これはmedia-useの文書化されたRWA系譜です。
  • 再利用ファースト: エコシステム内のLLM生成テンプレートに相当するものは、「カタログブロック + hyperframes-animation ルールを構成する」ことです。HFの一時停止されたGSAPタイムラインは、Remotionの useCurrentFrame に相当します。
  • カテゴリモジュール契約: 各 categories/<id>/module.md(計画 + ビルド)は、references/motion-vocabulary.md を共有します(オプションで評価も)。カテゴリを追加する = フォルダを配置 + agents/director.md にその分類行を登録 + catalog-map.md に行を追加。フェーズパイプラインは変更しません。
  • ディレクトリ構成:
    videos/<project-name>/
      hyperframes.json  context.log
      shot-plan.json            # IR(Director出力)
      assets/  assets/index.md  # media-use出力(ソースされた場合)
      compositions/index.html   # Builder出力
      renders/video.mp4
    
  • 登録: hyperframes ルーター内 — 「デザイン主導の短いモーショングラフィック」意図 + Workflow説明を追加; /general-video からモーション・グラフィックスのトリガーを切り出す; 逆の「Do NOT use」エッジを追加。motion-graphics-genre.md §5-7 を参照。

Individual skills in this repo

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

9018/mychat

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

9018/mychat

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

9018/mychat

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

9018/mychat

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

9018/mychat

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

9018/mychat

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

9018/mychat

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

9018/mychat

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

9018/mychat

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.

9018/mychat

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

9018/mychat

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. Read before writing composition HTML.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

9018/mychat

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.

9018/mychat

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

9018/mychat

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

9018/mychat

Download video and audio from YouTube and 1000+ sites using yt-dlp. No API keys needed. Use when: (1) Downloading a video from YouTube or other sites, (2) Extracting audio from a video URL, (3) Downloading subtitles/captions from a video, (4) Getting video metadata without downloading.

関連スキル