Communitygithub.com

dsauce/stickman-kino

棒人間キノフィルムをアニメーション化します - film.json/ストーリーボードからscenes.jsを書き、棒人間エンジン(58のポーズとIKを持つリギングされた棒人間、約190のプロップ、チャートと図、キネティックテキスト、キャプション、カメラワーク、エフェクト、環境、テーマ、トランジション)を使用して、ナレーションと同期させ、check + スナップショットで検証します。任意のシーン振付、モーション、レイアウト、ビジュアル修正作業に使用します。

stickman-kino とは?

このスキルは、Stickman Kinoエンジンを使用して棒人間アニメーション映画を作成するためのClaude Code(または類似のAIエージェント)向けのスキルです。`film.json`で定義された各クリップに対応する`scenes.js`を生成し、ナレーションと同期したアニメーション(58ポーズのリギングされた棒人間、190以上のプロップ、チャート、テキストエフェクト、カメラワークなど)を実現します。主なワークフローは、`stickman check`コマンドでJavaScriptエラーをチェックし、`stickman snapshot`コマンドでスナップショットを生成して視覚的に確認するというループです。マークダウンリファレンス(`references/api.md`と`references/cookbook.md`)に基づいてコードを記述し、チェーン可能なAPI、ボイス同期、レイヤリング、イージングなどの概念を理解する必要があります。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dsauce/stickman-kino/tree/HEAD/skills/stickman-animator

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

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

ドキュメント

棒人間アニメーター

あなたは**scenes.js**を書きます - 各クリップに対してfilm.scene(id, sc => { … })を、film.jsonと同じid、同じ順序で記述します。すべてはグローバルSMエンジンに対するプレーンなブラウザJSです。書き始める前にreferences/api.md(完全なチートシート)とreferences/cookbook.md(コピペレシピ集)を読んでください。

メンタルモデル

  • ローカル時間。 シーン内のすべての時間は、クリップ開始からの秒数です。sc.dur = クリップの長さ。
  • チェーン可能。 すべてのアクションは終了時間を返します:const t = bob.walkTo(900, 0.2); bob.wave(t);
  • ボイス同期。 sc.cue("word") = ナレーターがその単語を発声する推定ローカル時間(sc.cue(["word", 1]) = 2回目の出現、sc.cue(0.5) = VOの途中)。視覚効果は単語の上または直前に配置します(sc.cue("idea") - 0.15)。
  • レイヤー。 world(環境)→ back(プロップ)→ 図形 → front(図形の上のプロップ)→ ui(スクリーン空間、カメラを無視)→ top(トランジション)。プロップには{ layer: "front" } / "ui"を渡します。
  • 座標。 キャンバスはsc.W × sc.H(1920×1080、1080×1920または1080×1080)。sc.groundYは床(ランドスケープで80%ダウン、ポートレートで74%ダウン)。図形はy = 足の位置で立っています。
  • もの。 プロップ、テキスト、チャート、シェイプはThingです:.pop(t) .fadeIn(t) .rise(t) .dropIn(t) .slideIn(t,d,dir) .moveTo(x,y,t,d) .arcTo(x,y,t,d,h) .scaleTo .rotateTo .spin .pulse .shake .wobble .bob(t0,t1) .glow .tint .draw .fadeOut .popOut .hide .show。
  • 出現まで非表示。 { hidden: true }で作成し、.pop(t)します。テキストは.in(t, fx)まで非表示です。

シーンの骨格

const film = SM.film();                       // テーマ/フォーマットはfilm.jsonから

film.scene("hook", sc => {
  sc.enter("fade");                           // オプション、前のexitと合わせる
  sc.ground();                                // 床ライン(スタイル:"grass" | "none")
  const bob = sc.figure({ x: -150, face: "dots" });        // または sc.character("zeke", {...})
  const t1 = bob.walkTo(sc.W * 0.35, 0.2);
  bob.point(sc.W * 0.7, sc.H * 0.4, sc.cue("this"));
  const chart = sc.barChart({ x: sc.W * 0.68, y: sc.H * 0.45, data: [{ label: "2024", value: 4 }, { label: "2025", value: 9 }] });
  chart.grow(sc.cue("grew"));
  sc.text("Revenue [doubled]", { x: sc.W * 0.68, y: 150, size: 80 }).in(sc.cue("doubled") - 0.1, "words");
  sc.camera.focus(sc.W * 0.6, sc.H * 0.5, 1.12, 1.0, 3);   // スロープッシュ
  sc.exit("wipe-left");
});

イントロとアウトロ

film.jsonで"intro" / "outro"と宣言されたクリップは自動的に構築されます。それらのシーンを書く必要はありません。エクストラ(タイトル周りに飛び出すプロップ、CTAで手を振る図形など)を追加するには、シーンを書いて自分でプリセットを呼び出します。その場合、自動バージョンはスキップされます:

film.scene("intro", sc => {
  const t = sc.intro("countdown", sc.clip.intro);          // タイトルが配置された時間を返す
  sc.prop("rocket", { x: 1500, y: 300, size: 120, layer: "ui", hidden: true }).pop(t - 0.8);
  sc.exit("wipe-left");
});
film.scene("outro", sc => {
  sc.enter("fade", { color: "bg" });
  sc.outro("kino", sc.clip.outro);
  sc.figure({ x: 1500 }).point(1150, 830, 1.2);
});

演出ルール(見栄えを良くするためのルール)

  1. 2~3秒ごとに何かが変わる。 クリップあたり3ビートを計画し、ギャップをカメラプッシュ、まばたき/うなずき、プロップの揺れ、ハイライトで埋めます。
  2. アニメーションの前にステージを設定する。 図形、メインプロップ、テキストの配置を決めます(16:9では三分割、9:16では積み重ね)。テキストは図形の頭部や他のテキストから遠ざけてください。
  3. 図形は立っているだけでなく、動作する。 意味のあるジェスチャーを使います:議論しているものをpoint、アイデアの前にthink、暴露でsurprise、神話に対してshrug、勝利でcelebrate、努力のためにpush/climb/runTo。
  4. 焦点となる入場は一度に一つ;複数のものが現れる場合は0.1~0.2秒ずつずらします。
  5. クリップ間でexitとenterを一致させる(同じトランジションタイプ)、またはマッチカット(同じポーズ/オブジェクト位置)。
  6. アクセントは意味を持つ: "a1"問題、"a2"解決策、"a3"報酬。カラー名を渡します:"a1" | "a2" | "a3" | "ink" | "muted" | "soft" | "paper"または16進数。
  7. グラウンドトゥルース: 図形はsc.groundY(または計算した表面)に立ちます。床に置くプロップはy = sc.groundY - size*0.4を使います。
  8. ポートレート: 図形size: 420-460、プロップ200-300、テキスト70-120、中央の帯を忙しくし、キャプションは低く。

検証(必須ループ)

  1. stickman check <dir> → Check passedと表示される必要があります。page_error = JSがエラーをスローしました。修正してください。
  2. stickman snapshot <dir>(またはキービートで--at時間)→ snapshots/contact-sheet*.jpgとPNGを開いて確認してください。 修正:クリッピング、重なり、浮いている図形、空白の瞬間、読めないテキスト、頭を通る腕(ポーズオーバーライドを調整)、間違ったアクセントカラー。
  3. 問題がなくなるまで再実行し、その後レンダリングします。

落とし穴

  • 各図形を時系列でスケジュールします。celebrate()は+1.0秒後にstandに戻るスケジュールを設定します。すぐ後にまたポーズを取る場合は{ hold: true }を渡します。
  • bob.hold(prop)は右手に取り付けられ、直立したままになります。使用前に作成し.pop(t)します。
  • テキストマークアップ:"[アクセント付き単語]"はaccentオプション(デフォルトa2)でフレーズに色を付けます。
  • チャートは離散ステップで数字をカウントします。チャートオプションでprefix/suffix/decimalsを指定します。
  • Math.random/Date/setTimeoutは使用しないでください。SM.rng(seed)を使用します。
  • 生のGSAPは許可されています:sc.tl.to(el, vars, sc.T(localTime)) - 時間の純粋関数として保ちます。

関連スキル