Communitygithub.com

コードアニメーションスキル

抽象的な概念を1〜2分のアニメーション短編にします。**生成ビデオではありません**——各フレームはブラウザ内で計算されたベクター画像で、フレームごとに再現可能、部分的に修正可能です。

コードアニメーションスキル とは?

このスキルは、「コードアニメーション工房」であり、抽象的な科学・数学概念を1〜2分の説明アニメーション(MP4)に変換します。ストーリーの概要から、まず storyboard.json を生成し、それを元に canvas 上でベクター描画されたフレームをレンダリングします。生成AIによるビデオではなく、全フレームがコードで駆動されるため、ピクセル単位の再現性と修正が可能です。このプロセスは 3 つのステップ(lint、build+render、quality measurement)で構成され、品質はフレーム間差分や動きの比率などの定量指標で自動検証されます。対応プラットフォームは Claude Code、Cursor、Codex などのコード実行環境で、Python とブラウザベースのレンダリングを利用します。物理学、数学、天文学、歴史、技術解説など様々なトピックに対応し、テーマに合わせたBGM合成機能も内蔵しています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Shang-en-yee/code-animation-skill/tree/HEAD

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

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

ドキュメント

コードアニメーション工房 (Code Animation)

抽象的な概念を1〜2分のアニメーション短編にします。生成ビデオではありません——各フレームはブラウザ内で計算されたベクター画像で、フレームごとに再現可能、部分的に修正可能です。

成果物はMP4と、再利用可能な storyboard.json です。


3ステップのワークフロー

# 1. ストーリーボードの検証
python scripts/lint.py storyboard.json

# 2. ビルド + レンダリング(約0.5秒/フレーム)
python scripts/build.py storyboard.json out.html
python scripts/render.py --html out.html --duration 117 --fps 30 --out film.mp4

# 3. 品質測定、基準を満たさない場合は非ゼロを返す
python scripts/measure.py film.mp4 --thresholds reference/thresholds.json

品質測定に合格しなければ修正します。「見た目がまあまあ」で承認してはいけません。

BGMの追加(オプションですが強く推奨)

オーディオも計算によって生成され、素材ライブラリからサンプリングしません——映像と同じ考え方です。

# 1. BGM を合成(numpy、約40秒)
python scripts/make_audio.py score.wav --storyboard storyboard.json

# 2. 動画に合成、ついでに H.264 で圧縮
python scripts/mux.py --video film.mp4 --audio score.wav --out final.mp4 --crf 23

デフォルトのBGMは宇宙/物理テーマを想定:Dマイナーのロングトーンの土台 + シーンごとにコードが変わるパッド + 8秒ごとのハートビートパルス + まばらなアルペジオ、トランジションではノイズスイープ、チャプターでは低音の着地音があります。

テーマを変更する場合は、BGMパラメータもそれに合わせて変更し、そのまま流用しないでください:

テーマBGMの変更方法
物理 / 天文デフォルトを維持:マイナー、ロングトーン、まばら
数学 / アルゴリズムメジャーまたはリディアンモードに変更、規則的なアルペジオを追加
歴史 / 人文パルスを削除、パッドを遅く、不協和音程を追加
プロダクト / 技術パッドのロングトーンを削除、90–110 BPMのシンセグルーヴに変更

パラメータはすべて make_audio.py の先頭にある SCALE / ROOT / bpm の3つの定数と、build() 内の chords 配列にあります。


storyboard.json

{
  "title": "重力",
  "fps": 30,
  "palette": { "bg": "#08090F", "ink": "#E6DCCB", "dim": "#8A8177", "accent": "#E0813C" },
  "scenes": [
    {
      "id": "open",
      "kind": "title",
      "dur": 6.0,
      "cn": "重力",
      "en": "GRAVITY"
    },
    {
      "id": "newton",
      "kind": "orbit",
      "dur": 16.0,
      "chapter": ["I", "リンゴと月", "THE APPLE AND THE MOON"],
      "subs": [
        [0.6,  "1687年、ニュートンは一つの公式でリンゴと月を結びつけました。"],
        [7.4,  "重力は質量に比例し、距離の二乗に反比例します。"]
      ]
    }
  ]
}
フィールド説明
kindショットテンプレート名、下記参照
durショットの長さ(秒)、12〜20秒を推奨
chapter[番号, 日本語, ENGLISH]、左上に常時表示
subs[開始秒, テキスト] の配列;1画面あたり5〜6秒が適切
cn / enタイトル系ショットで使用

ショットテンプレート(8種類)

kind描画内容用途
title大きな文字 + 英語のサブタイトルオープニング
outro2行の結論エンディング
orbit楕円軌道 + 極座標グリッド周期運動、重力
precess歳差運動の花弁曲線 + 角度盤微小なずれ、歳差
elevator矩形 + 内部目盛り基準系、等価原理
warp透視投影された時空グリッド + 引出線ラベル曲がり、場
evidenceレンズ状の同心円環 + チャープ波形証拠、信号
blackhole降着円盤 + 光子リング + 環状目盛り極限天体

テンプレートのパラメータは templates/shots/*.json を参照。


6層アーキテクチャ(なぜこの順序か)

L5 ポストプロダクション    bloom → ビネット → ノイズ
L4 テキスト    チャプタータイトル / 大見出し / 数式 / 字幕
L3 ラベリング    引出線 + 小さなラベル + 数値表示枠
L2 メイン    ショットの中心となるグラフィック
L1 構造    グリッド / 目盛り / 座標軸
L0 背景    星雲 / 点群 / ダスト / 遠方の星

「プロフェッショナル感」はL1とL3から生まれます、L2だけではありません。メインオブジェクトだけの画面は貧弱に見えます。構造層とラベリング層を追加すると、同じ図が一瞬で「計器画面」に変わります。

base.html はすでに6層すべてを実装しており、新しいショットはL2の描画関数だけを書けば済みます。


品質測定の閾値

reference/thresholds.json:

{
  "frame_diff_min": 1.5,
  "moving_ratio_min": 0.70,
  "coverage_min": 0.20,
  "luma_range": [16, 30]
}
指標意味理由
frame_diff隣接フレーム間の平均差分1.5未満だと「スライドショー」でアニメーションではない
moving_ratio動きのあるフレームの割合70%未満だと「止まっている」感覚が出る
coverage局所構造のあるピクセルの割合20%未満だと画面が空っぽに見える
luma平均輝度16未満だと構造が黒に沈み、30を超えると暗いトーンが失われる

これらの閾値は実際のリファレンス映像で調整されています。簡単に変更しないでください。 詳細は reference/findings.md を参照。


既知の落とし穴(血と涙の教訓)

1. ctx.shadowBlur は絶対に使わないこと。 ソフトウェアレンダリングで数十箇所のフレームごとの影を付けると、1フレームが20msから5秒に跳ね上がります。代わりに base.html の bloom() を使ってください——キャンバスを1/6に縮小してから拡大して重ねる、2回の drawImage でほぼコストゼロです。

2. パラメータは同一ソースから取得すること。 かつて「質点が軌道の外を飛んでいる」バグが発生しました:線は p² で計算し、点は p で計算していたためです。同一要素のパスと先端は、必ず同じ変数で駆動してください。

3. ノイズがファイルサイズを決定します。 フレームごとのランダムノイズはエントロピーが極めて高く、ビデオコーデックで圧縮できません。ノイズα=0.03の場合、1080p30で約50KB/フレーム——2分の動画で約300MBになります。 サイズを抑えるにはαを下げる(0.015程度)かフレームレートを下げてください。コーデックに頼ってはいけません。

4. フレーム形式はJPEG、PNGは使わないこと。 ノイズを含むPNGのエンコード時間はJPEGの4倍以上です(実測:2.0秒/フレーム vs 0.5秒/フレーム)。

5. 明るさ調整はフィルターで行わないこと。 CSSの brightness() で明るくすると、テキストも一緒に白飛びします。明るくするにはコンテンツ層(グリッド、星雲、ダスト)のアルファを、reference/palette.json の比率に従って調整してください。


新しいショットの拡張方法

  1. base.html の drawScene() に case を追加
  2. L2(メイン)のみを記述;L1は polarGrid / ringTicks / axisTicks / drawInstrument を、L3は drawLeader を使用
  3. 調整可能なパラメータをオブジェクトとして抽出し、templates/shots/<name>.json に保存
  4. measure.py を実行し、3つの指標が基準を満たしていることを確認

サンプル

examples/gravity.storyboard.json —— 2分の完成作品「重力」の完全なストーリーボード、8つのショットすべてが実際に使用可能です。出発点として直接台本を書き換えて使用できます。

関連スキル