Communitygithub.com

toy-loops

Python と Blender で作る、紙製ジオラマ風のシームレスループ 3D アニメーション(GIF/MP4)と Web ヒーロー画像、ライブ Web 作品(Claude の目がカーソルを追う)。アニメーションの古典原則(予備動作、押し潰しと伸ばし、追従、オーバーシュート)を適用。Pimbo が GIF、ループ、トイ、紙製ジオラマ、Claude アニメーション、ヒーロー画像、マウス追従の目、Claude 3D モデルを要求したときに使用。

toy-loops とは?

toy-loops は、Python スクリプトと Blender を組み合わせて、紙製ジオラマ風のシームレスループ 3D アニメーション(GIF/MP4)を生成するスキルです。アニメーションの古典原則(予備動作、押し潰しと伸ばし、追従、オーバーシュート)を適用し、Pimbo が求めるループアニメーション、Web ヒーロー画像、または Claude の目がカーソルを追うライブ Web 作品を作成します。すべてのオブジェクトはコードで構築され、各フレームはフレーム番号から計算されるため、ループは正確に閉じます。Blender 5.2、ffmpeg、Python(numpy、Pillow)が必要で、Pimbo の PC では EEVEE レンダリングで 1080x1080 フレームあたり約 0.7 秒で完了します。出力は GIF/MP4 形式で、品質ゲート(QA)が設けられています。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Pimboto/claude-skills/tree/HEAD/skills/toy-loops

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

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

ドキュメント

toy-loops は何をしますか?

小さなペーパークラフトの世界(島、キャンプ場、映画セット)、俳優としての Claude、柔らかく暖かい光とミニチュアのような浅い被写界深度。すべてのオブジェクトはコードで構築され、すべてのフレームはその番号から計算されるため、ループは正確に閉じます。この見た目は、Pimbo のリファレンス anymation/3d_ref/style2 を reference-video-analysis スキルで分析したものから研究されました(初回パス: 3d_ref/style2/analysis/FIRST_PASS.md)。それらのリファレンスは非公開の学習教材です。技法はコピーしても、シーンはコピーしないでください。

ステータス: v1, 2026-11-18. このスキルで作成され、確認された作品:

  • claude_isla: Pimbo 承認("esta épica")。
  • claude_fogata: 2 つ目のループ。
  • director_hero: 2400x1200 の Web ヒーロー画像、2 色で作成。
  • claude_pose: ライブ Web の目があるカットアウト。
  • claude.glb: 3D モデル。

ファイル構成

コードは Pimbo の PC 上のフォルダ C:\Users\Pimbo\work\anymation\toy3d\skill にあります。以下のパスは、特に断りがない限り、その kit/ フォルダからの相対パスです。

パス内容
lib/toy.py見た目: 白い面取りエッジ、形状、ライト、カメラ、レンダリング設定の紙質マテリアル
lib/anim.pyアニメーター用ツール: イージング、Track(ポーズ間の補間)、スプリング、squash、arc、looped
lib/chars.pyClaude: リグと 6 種類の目セット; フレームごとに .pose(...) を 1 回
lib/runner.pyシーンをフレームごとにレンダリング; すべてのシーンは runner.run(...) で終了
loops/<name>/scene.py1 つのループアニメーション
stills/<name>/scene.py1 枚の静止画(T = 1)
tools/make_loop.pyレンダリング、GIF 1080/720 と MP4 x1/x3 へのエンコード、QA、コンタクトシートを 1 コマンドで実行
tools/qa_loop.pyループの継ぎ目、フレーム数、停止、リファレンスとの動きの比較
tools/duotone.py画像の青いモノクロームバージョン(Web ヒーロースタイル)
tools/web_eyes.py目をオフにしてレンダリングした Claude の目がカーソルを追う Web ページ
tools/claude_glb.pyClaude モデルを .glb(フラットカラー、白エッジ保持)として Blender 内で実行
out/<name>/出力: frames/、ファイル群、sheet.jpg、qa.json

完成した作品は anymation/toy3d/videos/<name>/ にコピーされます。Web 作品は anymation/toy3d/web/ に配置されます。

必要なもの:

  • Blender 5.2: Pimbo のポータブルコピーは anymation/tools/blender にあります。他の環境では $BLENDER を設定するか、blender を PATH に追加してください。
  • ffmpeg を PATH に追加。
  • Python(numpy、Pillow)をツール用にインストール。

Pimbo はスクリプトを実行しません。あなたが実行し、Pimbo に画像を見せます。

絶対に守るルール

  1. 作成前に表示する。 新しい世界やキャラクターを作る前に、2〜3 枚の静止画(--frames ... --scale 0.5)をレンダリングし、Pimbo に選んでもらいます。見せる前にすべての画像を自分で確認してください。
  2. pose(f) はフレームの純粋関数。 フレーム間で状態を保持せず、固定シードなしの乱数を使用せず、すべての周期運動はループごとに整数周期にします。ループの終わりをまたぐエフェクトには looped() を使用します。
  3. アニメーターのようにアニメートする(references/ANIMATION.md)。最初にドープシートを書き、次にイージングを適用したキーポーズを使用します。すべてのアクションの前に予備動作を、衝突時には押し潰しを、速度時には伸ばしを、腕にはオーバーラップを、そして 1 フレームの目の切り替えを行います。決して直線的に動かさないでください。
  4. QA に合格し(make_loop.py が PASS/FAIL を表示)、すべてのアクションをフレームごとに確認したストリップを見た場合のみ、ループは完了とみなします(下記「ストリップ」を参照)。
  5. 測定したものは [M]、目視したものは [V]、想定したものは [S] として明記します。

パイプライン

ステップ内容コマンド(kit/ から)
1アイデア: 場所、始まりとループバックのある小さなストーリー; 6〜9 秒Pimbo と相談
2最も近いシーンをコピー: loops/claude_isla(昼、屋外)または loops/claude_fogata(夜、小道具、エフェクト)
3セットを構築、Claude を配置、照明とカメラを設定; 静止画を確認python tools/make_loop.py <name> --frames 0 --scale 0.5
4ドープシートのコメント、次にトラック; キーポーズをレンダリングpython tools/make_loop.py <name> --frames 44,62,66,71,77,81
5ループ全体を高速プレビューpython tools/make_loop.py <name> --preview(8 フレームおき)
6フルレンダリング + GIF + MP4 + QApython tools/make_loop.py <name>
7各アクションのストリップ、修正、再レンダリング下記「ストリップ」を参照
8完成ファイルを anymation/toy3d/videos/<name>/ にコピーし、Pimbo に送信

Pimbo の PC(RX 6800 XT)でのタイミング [M]:

  • EEVEE: 1080x1080 フレームあたり約 0.7 秒。したがって、200 フレームのループは約 2.5 分かかります。
  • Cycles: フレームあたり約 10 秒で、見た目はほぼ同じです。静止画のみに使用: --engine cycles --samples 256 で 2400x1200 の場合約 20 秒。

ストリップ。 アクションをフレームごとに確認するには:

ffmpeg -framerate 25 -start_number 56 -i out/<n>/frames/%04d.png -frames:v 30 -vf "crop=...,scale=260:-1,tile=6x5" -frames:v 1 strip.jpg

見た目の概要(詳細と数値: references/LOOK.md)

  • トイスケール。 1 単位 = 1 m で、Claude の幅は約 9 cm。実際のカメラ被写界深度(70 mm、f/4.5-7)により、ミニチュアブラーが自動的に得られます。
  • 紙質。 すべての立体物に paper(...) が適用されます: マットな色、繊維の凹凸、柔らかな染み。面取りエッジには自動的に白エッジマテリアルが適用されます(box、prism、disc)。
  • 色。 ビュートランスフォーム AgX、Punchy ルック。露出は昼で -1、夜で約 -0.35。
    • 照明面: Claude の照明面はリファレンスに近い値(当方の #DA8D6C、リファレンス #EC815B)。
    • 明るさ: 昼のフレームの平均明るさは 120〜140(リファレンス 91〜181)。
  • ライト。 暖色のキーライトを高く前方に配置し、上面を前面より明るくします。弱い寒色フィルと暖色リムを追加します。発光するもの(炎、星、煙)には flame_mat と no_shadow を使用します。
  • カメラ。 ループ中は静止(リファレンスではカットまたはプッシュイン時のみカメラを動かす)。
    • GIF には正方形 1080。
    • ヒーロー画像はワイドで、shift_x で被写体を 3 分の 1 の位置に配置。

Claude の概要(references/CHARACTERS.md)

claude = Claude('claude', loc) と定義し、フレームごとに:

claude.pose(s, hop, pitch, roll, yaw, arm_l, arm_r, eyes, eye_big, eye_look, loc)
  • 目: sq(四角)、happy(^ ^)、line(- -)、squeeze(> <)、dot(. .)、sad。
  • 小道具: 保持する小道具は claude.hand(side) にペアレント化。
  • 手を振る: 手を振る腕はカメラに向いている方の腕。

Web 作品: ライブの目と 3D モデル

  • ライブの目。
    1. --eyes-off を指定してレンダリング(カットアウトの場合は --transparent も): python tools/make_loop.py claude_pose --transparent --eyes-off --tag _noeyes。ランナーは目を非表示にし、eyes.json を書き出します: 各目のピクセル中心と、顔の軸(ピクセル/mm 単位)。
    2. python tools/web_eyes.py <noeyes.png> <eyes.json> <out_dir> --ink-from <render with eyes> を実行。index.html と単一ファイル <dir>_un_archivo.html が書き出されます。
    3. ページの動作:
      • 目は顔の平面上に描画された SVG 図形で、傾いた顔でも遠近感が正しく保たれます。
      • 減衰付きスプリングでポインターを追跡し、2.5〜5.5 秒ごとにまばたきします。
      • ポインターが近いときは ^ ^、押している間は > <。
      • クリック時に押し潰しと伸ばしのバウンス(--hero の場合はなし。静止画を維持)。
    4. Chrome で playwright を通してテスト済み(ポインター左、右、上、下、近接、押下、解放): コンソールエラーなし。
  • 3D モデル。 blender -b --factory-startup --python tools/claude_glb.py -- <out.glb> [--eyes sq] を実行。約 27 KB の GLB ファイルが書き出され、幅は約 9 cm。再インポートして確認済み。
  • シーンと --eyes-off。 ビルド時に Claude をポーズするシーンは、pose(f) 内でも再度ポーズする必要があります。--eyes-off はそこで効果を発揮します(stills/director_hero を参照)。

品質ゲート(tools/qa_loop.py)

FAIL:

  • フレーム数が間違っている。
  • 継ぎ目がある: 最後のフレームから最初のフレームへの変化が、通常の変化の 90 パーセンタイルより大きい。

WARN:

  • 連続する同一フレーム(停止)。
  • 動きが平均明るさの 0.8% 未満。測定 [M]: リファレンス r2/r3/r4 は 1.65/1.97/1.07%、claude_isla は 0.89%、claude_fogata は 1.66%。

QA はセンス、演技、フレーミングを判断できません。これらは静止画とストリップで目視確認します。

既知のエラー(references/KNOWN_ERRORS.md)

再レンダリングが必要になるもの:

  • 腕を約 70° 以上上げると、体の横に隠れる。
  • 明るい発光が AgX で白飛びする: flame_mat を使用。
  • サイドキーライトが前面を暗くする。
  • 絶対的なグレーレベルで測定された夜のシーンが「静かすぎる」と感じられる。
  • 湾曲した背景アークが狭すぎて、その端が見える。

Individual skills in this repo

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

関連スキル