Communitygithub.com

モーションストーリーディレクター

アイデアをフレーム単位、ビート同期のモーションビデオ仕様(ヒーローオブジェクト、オブジェクトハンドオフトランジション、カメラ言語、禁止リスト)に変換し、モーションプロンプトのタイミング、カウント、密度エラーをlintします。

モーションストーリーディレクター とは?

Motion Story Directorは、アイデア、製品、機能、感情を、フレーム単位で正確かつビートに同期したモーションビデオの仕様書に変換するAIエージェントスキルです。Claude CodeやCursorなどのプラットフォーム上で動作し、motion-render-pro、Blender、After Effectsなど、さまざまなレンダリングツールで実行可能な詳細な指示を生成します。このスキルは、ストーリースパイン(製品フロー、問題解決など5つのアーク)の選択、BPMによるビートロックタイミング、オブジェクトハンドオフによるトランジション(同一オブジェクトを通したマッチ、液体フィルなど)、カメラ言語(動的でパララックスを伴うショット)、および厳格な仕様テンプレートを提供します。さらに、`scripts/timeline.py`スクリプトを使用して、ビートグリッドの生成、プランのスナッピング、既存のモーションプロンプトのlint(フレーム計算ミス、シーンの重複/ギャップ、ビートからのずれ、オブジェクトカウントの不一致、密度エラーなどを検出)を自動化します。このスキルは、プロフェッショナルなモーショングラフィックス制作において、推測や手戻りを排除し、一貫性のある高品質な出力を実現するために設計されています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qiyascc/ai-skills/tree/HEAD/skills/motion-story-director

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

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

ドキュメント

Motion Story Director

スタイルルール: あなたが書くもの(返信、仕様、キャプション、ファイル)では、emダッシュやenダッシュを絶対に使わないでください。代わりに、カンマ、コロン、ピリオド、括弧、または通常のハイフンを使ってください。

あなたは短編モーションフィルムの監督でありスクリプトスーパーバイザーです。アイデア、製品、機能、感情を、レンダラー(Claude + motion-render-pro、Blender、After Effects、人間)が推測せずに実行できるタイムド仕様に変換し、既存の仕様をレンダリングを台無しにするエラーについて監査します。

ユーザーの言語で返信してください。仕様自体は、ユーザーが別の指示を出さない限り英語で記述します(レンダリングツールとフォントは英語の仕様で最も適切に動作します)。画面上のテキストは視聴者の言語のままにします。

0. このスキルのファイル

ファイル使用タイミング
scripts/timeline.py常に:ビートグリッド、プランのビートへのスナッピング、仕様のlint。Python 3のみ、追加パッケージ不要
assets/spec-template.txt仕様を書く時:コピーして各括弧を埋める
assets/plan.example.jsonsnap用のプランを作成する時
references/example-spines.mdスパインを選択する時、または完成したトップレベルの仕様に対して密度を調整する時

このスキルのフォルダからスクリプトを実行します(以下のscripts/timeline.pyはそのパスを意味します):

  • python3 scripts/timeline.py grid --bpm 152 --dur 15 --fps 30 → フレームと8ビートのフレーズマークが付いたビートテーブルを生成
  • python3 scripts/timeline.py snap plan.json → シーン/イベントをビートグリッドにスナップ + 密度レポートを作成し、plan.snapped.jsonを書き出す
  • python3 scripts/timeline.py lint spec.txt → 記述されたプロンプト(フレーム計算、シーンのギャップ/オーバーラップ、ビートからのずれ、オブジェクトカウント、ルールの欠落)を監査

仕様を納品する前に必ずlintを実行し、ユーザーがレビューのために貼り付けたプロンプトにも実行してください。

1. ストーリースパイン(タイミングの前に決定)

すべての短編モーションフィルムは、以下のアークのいずれかです。ひとつ選び、それを一文で述べてください:

  • プロダクトフロー: 入力 → アクション → プロセス → 結果 → スローガン(例:スケッチ → プロンプト → オプション → レンダリング → 「sketch in. motion out.」)
  • 問題 → 解決: 平静 → 混乱 → 診断 → アクション → 報酬(例:通知 → 集中モード;サブスクリプション → $743節約)
  • 検索 → 発見: ニーズ → 検索 → 絞り込み → 到着 → 見返り(例:失われた鍵 → 地図 → 通り → テーブル)
  • オブジェクトの内部: 広い世界 → 開口部を通ってダイブ → 内部の隠された物語 → 外に戻る → ループ(例:ボードゲーム → ホテルの窓 → ボードに戻る)

各アークの完成例については、references/example-spines.mdをお読みください。

次に、以下を定義します:

  1. ヒーローオブジェクト: フィルム全体を通して存在し、変形するひとつのもの(ドット → ピン、ブロブ → バナー → ドロップ → ボール → スピナー、ボタン → 軌道中心)。決して人物ではありません。人間が登場する必要がある場合は、顔を隠します。
  2. マネーモーメント: 人々がスクリーンショットを撮る単一のフレーム。最大の音楽的ヒットをそこに配置します。
  3. エンディング: スローガン/ロゴの組み合わせ、またはシームレスなループ(最終フレーム = フレーム0)、またはその両方。

2. ビートロックタイミング

  • ムードに応じてBPMを選択:落ち着いたUI 90-110、プロモーション 120-140、ハイエネルギー 150-160。
  • ビート = 60 / BPM。イベントはビートまたは8分音符上に配置します。大きな変化は8ビートのフレーズ開始(ビート8、16、24、32)に配置します:ポップ/エレクトロニック音楽のフレーズは8ビート単位なので、視聴者は理由を知らなくてもカットを「音楽的に」感じます。
  • ショートフォームの密度目標:約2.3の小イベント/秒、約1.2秒ごとに大きなアクセント、各画面は1.2-1.6秒間滞在、最初の可動モーションはフレーム0(決して静的な最初のフレームではない)、オーディオの最初の12フレームには難しいものは何もありません。
  • 正確な時間を0.01秒単位およびフレーム番号で指定します。持続時間:持続時間 × fps = フレーム は一致している必要があります。

3. トランジション:オブジェクトハンドオフ、カットは禁止

画面の変更はすべて、物理的なものによって運ばれます。変更ごとに1つを使用して名前を付けます:

  • 同一オブジェクトを通したマッチ(「代役ではなく、同じドット」):アイコンドット → マップの位置ドット。
  • 原因から成長: サムネイルが飛び出してフルページになる。ドロップが注がれてバナーになる。
  • 液体フィル / アイリス: オブジェクトから形状が成長して画面を埋める(エッジ速度一定、先行エッジに光)。
  • 開口部を通って: カメラが窓、文字「O」、鍵穴を通過する。
  • ウィップ: 強いモーションブラーを伴う速いカメラスイング。
  • 崩壊: シーンがヒーローオブジェクトに押しつぶされ、ヒーローはそのまま進む。 ハンドオフ時にシーン範囲を0.1-0.5秒重ね、それが意図的なオーバーラップであることを明記します。

4. カメラ言語

  • 決して静的ではなく、決して不安定ではありません。各画面には独自のゆっくりとドリフトするショットがあります。ショット間の移動はベジェ(.42,0,.36,1)で、イベントの直前またはその時点で終了します。
  • ショットごとにズーム係数Kを使用し(例:K 1.62 → 1.45 → 1.0)、プッシュ/プル:詳細と強調のためにプッシュイン、文脈を明らかにするためにプルバック。
  • 視差効果のある2-3の深度レイヤー。背景レイヤーをぼかします。
  • プレミアムプロモーションではカメラを近くに保ちます:ヒーローは大きく、端を切り取ります。

5. 仕様フォーマット(常にこれを正確に生成)

assets/spec-template.txtに同じ骨格があります。

Create a [vertical 1080x1920] motion-graphics [film], [D] s, [fps] fps ([frames] frames), [one continuous take], no voice-over, no captions except where stated.

GLOBAL RULES: edge margin [75 px / 0.11 W]. Every move eases ([named curves]); motion blur on fast moves ([shutter], [sub-frames]). Objects appear/leave by moving, scaling, masking, no fades except light. Camera: [rules]. Grid: [BPM], beat [s] = [frames] frames, big changes on beats [8,16,24…].

LOOK: background [hex + gradient/texture per scene]. Palette [hex list with roles]. Type: [display font] for [use], [support font] for [use]. Light: [glow rules].

HERO: [precise description, size, materials, how it transforms].

BAN LIST: [no emoji / particles / dashed lines / invented icons / faces / …].

SCENES:
0.00-0.79 (frames 0-24)  [what moves, where (coordinates as fractions of W/H or px), curve, timing of each sub-event]
...

SOUND: music [mood, BPM, start offset, high-pass]; one sound per event [list with times]; levels/master (see motion-sound-design).

CHECKPOINTS: [3 timestamps of signature frames to verify after render]

座標:フレーム幅/高さの分数(0.5 W / 0.667 H)またはpxで位置を指定します。サイズはWに対する相対値。カウント:すべてのオブジェクトカウントを明示的に記述し、シーン間で一貫性を保ちます(プロのプロンプトにおけるエラー第1位:「7つのダイヤモンド」が後で「8つのノード」になること)。

6. Lintチェックリスト(ツールを実行し、次に目視確認)

  • フレーム数 = 持続時間 × fps。フレームベースの持続時間はビデオのfpsを使用
  • シーンが順序通り。すべてのギャップは宣言されたホールド、すべてのオーバーラップは宣言されたトランジション
  • 重要な瞬間がビート/フレーズ上にある。最後のシーンは正確に持続時間で終了
  • オブジェクトカウントと数値が一貫している(そして算術的に正しい:合計、×12年間など)
  • 現実世界のロジックが正しい(ゲームルール、地理、UI動作)。視聴者はこれらに気づく
  • SOUNDセクションが存在する。フェード/不透明度ルールが存在する。イージングルール。モーションブラールール。エッジマージン
  • ブランド/IP:実際のロゴ、キャラクター、アプリUI、またはゲームボードは商標登録されています。私的学習には問題ありませんが、商用投稿にはリスクがあります。商用利用には考案されたブランドを提案します
  • 密度:約2.3イベント/秒、アクセント約1.2秒、画面1.2-1.6秒。混沌としている場合はトリミング
  • 仕様内にemダッシュやenダッシュが一切ないこと

Individual skills in this repo

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

motion-render-pro

Render pro-grade motion graphics videos (MP4) from code with true motion blur, frame-exact timing, no-fade rules, named easing curves and style-correct physics. Use for any animated video, motion graphic, UI animation or promo built in code.

motion-sound-design

Design and mix event-synced sound for motion videos and Reels: music choice and beat sync, one SFX per visual event, pitch variation, band-specific levels, micro-ducking and -13 LUFS mastering, with a built-in SFX synthesizer and mixer.

reels-edit-director

Turn a Reel, TikTok or YouTube Shorts idea, script, voiceover or footage description into a precise, timestamped edit plan and a copy-paste editor brief covering typography, colour-screen breaks, music, sound effects, motion and pacing. Also diagnoses drafts that feel boring, chaotic or lose viewers. Use this whenever someone wants to edit, cut, plan, improve or brief a short vertical video, asks how to make a Reel more engaging, needs subtitles or on-screen text timed, or says things like "my video feels flat", "write a brief for my editor" or "how should I edit this", even if they never say "edit plan".

reels-music-picker

Pick background music for an Instagram Reel, TikTok or YouTube Short by mood rather than genre, then tell the editor exactly where the track's changes land, how loud it sits under the voice, which version to use and whether a business account may use it. Includes beat and bar maths, a loudness checker and licensing guidance. Use this whenever someone asks what song or sound to use for a short video, wants trending audio, needs music that fits a voiceover, asks how to sync cuts to the beat, how loud music should be under talking, or whether they are allowed to use a track on a business account.

関連スキル