Communitygithub.com

craft-2d-animation

エージェントが2Dアニメーションの計画、制作、編集を行い、ショットごとに説明可能な動画を出力する手順を提供します。EffectCraftとFilmCraftを用いて、視覚的な方向性とショット構成を重視します。

craft-2d-animation とは?

このスキルは、Claude CodeなどのAIエージェントが2Dアニメーションの制作プロセス全体を計画・実行するための体系的なガイドラインです。EffectCraft(アニメーション制作ツール)とFilmCraft(編集・出力ツール)を連携させ、イントロ、プロダクトデモ、短いシーン、短編映画などの2Dアニメーションを、音楽の有無にかかわらず制作できます。手順は、視覚的な方向性とシーンの可読性(色による場所の識別、シルエットのコントラスト、カメラ移動に対応した背景サイズなど)、ショットの構成と視覚文法(画角の種類とその役割、カメラフォーカスの計算式)、ポーズ変更とアニメーションの重み(アンチシペーション・アクション・フォロースルー)、キャラクター・カメラのアンカー設定とスタッキング順序(EffectCraft特有のバグ回避のためのルール)、テキストの可読性とダイジェティック/オーバーレイの分離、リソース効率の良いレンダリング確認方法までカバーします。再利用可能なスクリプト(ec_runtime.py、render_ec_batch.sh、assemble_filmcraft.py)が提供されており、CLIコマンドで依存関係の確認、プレビューレンダリング、マスター出力とクリーン出力を効率的に行えます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NelaBDV/craft-video-kit/tree/HEAD/skills/craft-2d-animation

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

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

ドキュメント

Craft 2D Animation (EffectCraft + FilmCraft)

EffectCraft(オプションでFilmCraftでの編集・出力も可)を使用して、イントロ、プロダクトデモ、短いシーン、2D短編アニメーションをデザイン、アニメーション化、組み立てるための汎用的で再利用可能な方法です。音楽トラックの有無を問いません。

共有CLI/MCPリファレンスとFlatpakパーミッション:../craft-music-video/references/mcp-and-commands.md。


1. ビジュアルディレクションとシーンの可読性

  1. 色で識別できる場所:短いシーンは最大2〜3つの場所に制限し、それぞれに支配的な照明と専用のパレットを割り当てます(例:暖かく暗い廊下、画面に照らされた作業スペース、エラーや警告用に1色のみのアクセントカラーを持つ明るい部屋)。
  2. 中抜きの輪郭ではなく塗りつぶされたシルエット:キャラクターと背景は塗りつぶされた幾何学的形状(ベジェ曲線または角丸長方形)で構築し、ミニマルな顔(目、眉毛、口はシンプルに)と、光源側にわずかな逆光線(リムライト)を追加します。
  3. シルエットのコントラスト:サムネイルの段階から各キャラクターを区別します(例:丸みを帯びてうずくまるシルエット vs 角ばった肩と素早い動きの直立したシルエット)。
  4. カメラ移動のための拡大された背景:背景/壁はフレームよりも広く描画します(1920×1080でズーム/シェイクの場合は2200–2400 px、パノラマトラベリングの場合は3600+ px)。これにより、フレーム端に10〜20ピクセルの黒い境界線が表示されるのを防ぎます。

2. フレーミングとビジュアルグラマー

ショットサイズを変えて、不必要なテキストなしでアクションを伝えます:

ショットサイズナラティブ上の役割技術的なベストプラクティス
ロングショット( Establishing )場所、照明、要素の相対的な位置を提示する同じ場所に戻ったときに、固定された空間的な目印(机、画面、パネル、ドア)を維持する
オーバー・ザ・ショルダー( OTS )キャラクターの目的と、インターフェースやオブジェクトに対する視点を示す最初の試行と最終的な成功の間でまったく同じOTSフレーミングを再利用し、即座に視覚的なコールバックを生み出す
ミディアムショット / プロフィール姿勢、動き、シーンの物理的な変化を追う徐々にうずくまる、椅子を後ろに下げる、または大きなジェスチャーを示すのに理想的
クローズアップ( Close-up )意図、インターフェースの細部、キーを押す手、視線、ギャグを切り取る動きは短く読みやすく保つ;クローズアップを利用して、すっきりとした負のスペースを生み出す

カメラフレーミングの計算 (cam_focus)

アンカーヌルカメラが[0, 0]の場合、ワールド上の点(tx, ty)を、スケールsc %のフレームW × Hの中央に配置するには、次の式に正確に従います: pos = [W / 2 - (sc / 100) * tx, H / 2 - (sc / 100) * ty] (ec_runtime.py内のcam_focus(tx, ty, scale_pct, width, height)で直接利用可能です)。


3. ポーズの変更、重み、視覚的リズム

  1. 予備動作 → アクション → オーバーシュート / ホールド:
    • ポーズAからポーズBへ直線的に移行しないでください。
    • アクションの前に、逆方向の小さな予備動作を追加します(例:キーを叩く前に指が上がってためらう、ドアがバタンと閉まる前に少し開く、後退する前に体が支えをとる)。
    • わずかなオーバーシュートまたは読み取り可能な停止(ホールド)で終了して、重みを与えます(例:キャラクターが一歩下がって、自分の仕事を賞賛するために一呼吸置く)。
  2. 段階的な姿勢の変化:待機中または緊張が高まっているときは、常に浮遊させるのではなく、ショット間で明確な段階を経て姿勢を変化させます(胴体の傾き、頭を下げる、腕のリラックス)。
  3. アクション間のショットの保持:すべてのレイヤーを常に動かし続けるのではなく、アクセントの間(まばたき、スローズーム、点滅するカーソル)に構図を呼吸させます。
  4. 必須の無音テスト:すべてのアクションシーン、イントロ、デモを音声なしで(または3〜5枚のrender-frameキーフレームキャプチャを介して)視聴します。キャラクターの目的とシーンの進行は、映像だけで100%理解可能でなければなりません。

4. キャラクターアンカー、カメラアンカー、スタッキング順序(EffectCraftの落とし穴)

これらのルールは、EffectCraft(After Effects互換の動作)での位置ずれ、パーツの分離、要素が隠れるなどのバグを回避します:

A. ヌルとカメラ

  • comp.layers.addNull()は、デフォルトでアンカーを[50, 50]、位置を[960, 540]に作成します。ヌルを配置またはペアレントする前に、常にanchorPoint.setValue([0, 0])を強制してください(これはec_runtime.pyのmakeCamNullが行うことです)。
  • child.position.setValue(...)の前に、常にchild.parent = parentを割り当ててください。これにより、childの座標が親のローカル空間で直接解釈されます。

B. ペアレンティングとトランスフォームに関する絶対ルール

  • 親がニュートラルポーズの間(rotation = 0°、scale = [100, 100])に、すべての子をアタッチします。
  • 初期回転、カメラズーム、または親のキーフレームは、子階層全体の作成が完了した後にのみ適用します。
  • 理由:child.parent = parentを割り当てる前にparent.rotationまたはparent.scaleを変更すると、AEスタイルの逆補正がトリガーされ、頭/腕が体から離れたり、背景全体がフレームの隅に縮小されたりします。

C. 関節2Dキャラクターのアンカー階層

  • 着席キャラクター:Rootを腰(hip_pos)に → Chair、Legs、TorsoNull(胴体ピボット[0, 0]) → BackUpperArm(肩) → BackForeArm(肘) → TorsoBody → Head(首の付け根) → UpperArm → ForeArm
  • 立位キャラクター:Rootを足の間の床(foot_pos)に置き、ズームや後退時に靴が床に固定されるようにする → LegBack / LegFront(腰ピボット) + TorsoPivot(腰ピボット) → Arms、Blazer/Body、Head
  • 首/襟の接続:常に、襟/首の塗りつぶし形状を、胴体の上部と頭の下部に重なるように追加します。これにより、強い傾き(25°~35°)があっても、あごと肩の間に隙間が生じることはありません。

D. スタッキング順序

  • 同じシェイプレイヤー内(ADBE Root Vectors Group) :最初に追加されたグループが一番上に描画され、最後に追加されたグループが一番下に描画されます(前 → 後ろの順序)。
  • コンポジション内の個別レイヤー間:新しいレイヤーはインデックス1(一番上)に挿入されます。レイヤーは後ろ → 前の順序で構築します(背景 → グロー → 背景 → キャラクター → 前景)。

5. テキストの可読性とダイジェティック/オーバーレイの分離

  1. 恒久的な黒帯は禁止:タイトル、字幕、キャプションは各ショットの空いている負のスペース(画面の上、壁の暗い隅、地平線の下)に配置し、顔、画面の境界線、背景のパネルと重ならないようにします。
  2. コントラストとセーフマージン:
    • ソフトなドロップシャドウ(ADBE Drop Shadow、不透明度190–230、距離4–6 px、ブラー14–18 px)を適用して、明るい背景と暗い背景の両方での可読性を確保します。
    • 水平方向のセーフマージン(1920×1080で>= 70 px)と、読み取り可能なホールド時間(アクションまたは最後の単語の終了後>= 0.35秒。ショットカットをまたいでも)を遵守します。
  3. ダイジェティックテキスト(V1)とスーパーインポーズテキスト(V2)の厳格な分離:
    • 背景に統合されたテキスト(V1):看板、画面インターフェース、書類、黒板、キーボードのキー。アニメーション世界の一部であり、すべての書き出しに存在します。
    • スーパーインポーズテキスト(V2、ProRes 4444 RGBA):タイトル、テロップ、字幕、歌詞、UI注釈。これらを別々の透明コンポジションに配置することで、タイトルありバージョンとクリーンバージョンを、編集的にまったく同じ状態でワンクリックで書き出せます。

6. ビジュアルチェックとリソース効率の良いレンダリング

  1. 動画レンダリング前のキーフレームチェック:ショットごとに1〜2個のキーとなる瞬間でeffectcraft-cli render-frame --max-side 960を使用し(オーバーレイV2の場合は--transparent)、フレーミング、関節の接続、テキストの可読性を数秒で確認します。
  2. 安全なシーケンシャルレンダリング(8GB RAM / 低性能CPUマシン向け):
    • 一度に1つのコンポジションのみレンダリングします(8GB RAMでProRes 4444 RGBAの並列レンダリングは避けてください)。
    • スレッドを制限し(RAYON_NUM_THREADS=2、OMP_NUM_THREADS=2)、低優先度で起動し(nice -n 15 ionice -c 3)、VRAMがシステムRAMと共有されている場合は--gpuを避け、メモリ解放のためにレンダリング間に2秒の間隔を空けてください。

7. 共有T3 Codeツールと依存関係

再利用可能なスクリプトは ~/.t3/shared/craft-video/ にあります:

ツールパス2Dアニメーションでの使用法
EffectCraft用ランタイムJSX~/.t3/shared/craft-video/ec_runtime.pyJsxBuilder、cam_focus、hex_to_rgba、run_effectcraft_scriptをインポートして、.ecproj(アンカー[0,0]、ベジェ、グロー、スムーズ/ホールドキーフレーム)を適切に生成する
バッチシーケンシャルレンダリング~/.t3/shared/craft-video/render_ec_batch.shffprobeによる自動再開機能付き低負荷で、V*シーン(ProRes HQ RGB)とL*/T*オーバーレイ(ProRes 4444 RGBA)をレンダリングする
FilmCraftアセンブル&書き出し~/.t3/shared/craft-video/assemble_filmcraft.pyV1(+ オプションでV2アルファとA1オーディオ)をRec.709で.fcprojにアセンブルし、Master + Cleanを書き出す

必要な依存関係

  • Python 3.9以上(標準ライブラリのみ)
  • ffmpeg と ffprobe
  • EffectCraft CLI(effectcraft-cli または Flatpak ai.storyteller.effectcraft、--filesystemアクセス付き)
  • FilmCraft CLI(filmcraft-cli または Flatpak ai.storyteller.filmcraft、マルチトラックアセンブル/書き出し用)
  • Linuxでオプション:nice、ionice、taskset

コマンド例

# 利用可能な依存関係を確認する(レンダリングなし)
python3 ~/.t3/shared/craft-video/ec_runtime.py --check-env

# 低負荷シーケンシャルレンダリングプランをプレビューする(シーン + アルファタイトル)
~/.t3/shared/craft-video/render_ec_batch.sh \
  --project ./projects/demo_2d.ecproj \
  --out-dir ./renders_vfx \
  --rgb V01_Intro,V02_Demo \
  --rgba T01_Intro,T02_Demo \
  --threads 2 --cores 0-3 --dry-run

# 音楽なしのFilmCraftアセンブリをプレビューする(無音のイントロ/デモ、Master + Clean)
python3 ~/.t3/shared/craft-video/assemble_filmcraft.py \
  --out-fcproj ./projects/demo_2d.fcproj \
  --v1-clips ./renders_vfx/V01_Intro.mov,./renders_vfx/V02_Demo.mov \
  --v2-clips ./renders_vfx/T01_Intro.mov,./renders_vfx/T02_Demo.mov \
  --export-master ./exports/demo_2d_titles.mp4 \
  --export-clean ./exports/demo_2d_clean.mp4 \
  --dry-run

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル