Communitygithub.com

Aseel1600/Edit01

短く、デザイン主導のモーショングラフィックスを作成します。動きそのものがメッセージとなる、ナレーションのない10秒未満の動画(キネティックタイポグラフィ、数字カウントアップ、ロゴスティングなど)に最適です。MP4または透明オーバーレイとしてレンダリングします。

Edit01 とは?

このスキルは、ナレーションやライブアクション主体ではなく、動きそのものがメッセージとなる短尺(10秒未満、最大約30秒)のデザイン主導型モーショングラフィックスを作成するためのディスパッチエントリです。対応カテゴリは、キネティックタイポグラフィ、統計数値のカウントアップ、チャート/データビジュアライゼーションの表示、ロゴスティング、ブランドロックアップ、ローワーサード、コールアウト、ソーシャルオーバーレイ、アニメーション化されたヘッドライン/ツイート/ニュースアイテム、モーションポスター、キャプチャしたページのハイライトなど多岐にわたります。アセットファーストのアプローチを採用しており、ショットのデザインに先立ってアセット戦略を決定し、実際の素材を調達した上で、カタログ機能を再利用して構成します。ワークフローは初期化、計画(検索の必要性判断とカテゴリ分類)、アセットソーシング(検索駆動型カテゴリの場合)、デザイン、ビルド(再利用ファースト)、レンダリング(MP4または透明オーバーレイ)、検証の各フェーズで構成されます。macOS Apple SiliconまたはLinux x64環境で動作し、Node.jsとFFmpegが必要です。より長尺でナレーションのある作品(general-video)、ナレーション付きWebサイト動画(website-to-video)、トピック解説(faceless-explainer)、商品プロモーション(product-launch-video)、既存映像へのキャプション追加(embedded-captions)には使用しないでください。

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

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

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

ドキュメント

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

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

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

フェーズ実行主要なアーティファクト詳細なフロー
initBashhyperframes.jsonステップ0
planサブエージェント — 検索の要不要を判断 + 分類 + アセット戦略shot-plan.json (ドラフト: カテゴリ, asset_needs クエリ, ブリーフ)agents/director.md (パート1)
source ◇Bash — media-use resolve (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.mp4ステップ5
verifyBash — lint / inspect -> 失敗時に修復サブエージェント(その場で修正)agents/finalize.md

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

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

plan の 最初の判断は「検索が必要か?」 です。この分岐によりカテゴリは2つのグループに分割されます。その後、検索駆動型の場合は、検索が返すコンテンツの種類によって特定のカテゴリが選択されます。各カテゴリは1つの 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 を一度実行。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 — 初期化

カレントワーキングディレクトリはエージェントワークスペースルートです。すべてのアーティファクトを 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 は使用しないでください。

ステップ1 — 計画(サブエージェント: ディレクター パート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)は、ステップ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 をラップ。検索駆動型カテゴリはニュース/ウェブ/ツイート/画像検索を使用)。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 — デザイン(サブエージェント: ディレクター パート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 — ビルド(サブエージェント: ビルダー、再利用ファースト)

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

ステップ5 — レンダリング(Bash)

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

ステップ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 なしステップ1(計画)
shot-plan.json に asset_needs あり、assets/ なしステップ2(ソーシング)
shot-plan.json 最終版、compositions/index.html なしステップ3/4(デザイン+ビルド)
compositions/index.html あり、renders/video.mp4 なしステップ5(レンダリング)+ ステップ6
renders/video.mp4 ありレポート + 停止

デザインノート(メンテナー向け — 実行時はこのセクションを読みません)

  • アセットファーストの根拠: ソーシングは前倒しされ、ショットデザインに情報を提供します(RWAフロー: 分析 → 検索 → レビュー → 構成)。検索駆動型カテゴリ(webpage/news/tweet)と asset-fusion はどちらも media-use 検索(ニュース/ウェブ/ツイート/画像)に依存しており、これは media-use の文書化されたRWA系統です。
  • 再利用ファースト: LLM生成テンプレートのエコシステム内アナログは「カタログブロックの構成 + hyperframes-animation ルール」です。HFの一時停止されたGSAPタイムラインは、Remotion の useCurrentFrame に相当します。
  • カテゴリモジュール契約: 1つの 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(ディレクター出力)
      assets/  assets/index.md  # media-use 出力(ソーシングされた場合)
      compositions/index.html   # ビルダー出力
      renders/video.mp4
    
  • 登録: hyperframes ルーター内 — 「デザイン主導の短いモーショングラフィック」インテント + ワークフローの説明を追加。/general-video からモーショングラフィックストリガーを切り出す。逆の「使用禁止」エッジを追加します。詳細は motion-graphics-genre.md §5-7 を参照。

Individual skills in this repo

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

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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.

Aseel1600/Edit01

Generate expressive, multilingual narration with fish.audio (S1 / S2-generation models) and reuse cloned voices via reference_id. Use when the user prefers fish.audio/Fish Audio TTS, wants a specific playground voice model, or needs high-emotion voice-clone narration.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

Best practices for Remotion - Video creation in React

Aseel1600/Edit01

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.

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

関連スキル