sprite-stacking は Daniel White さんが公開しているオープンソースのエージェントスキルです。物体を 4 方向(上・横・正面・背面)から描いたドット絵を渡すと、「スプライトスタック」を作ってくれます。スプライトスタックとは平たいスライスを横に並べた画像のことで、ゲーム側でこれを重ねて描くと、回転できる 3D オブジェクトのように見えます。対応エージェントは Claude Code、Codex、Cursor、OpenCode、Gemini CLI、Pi です。リポジトリの作成日は 2026 年 11 月 20 日で、2026 年 11 月 21 日に確認した時点のスター数は 187、ライセンスは MIT です。
この記事では、スプライトスタッキングとは何か、このスキルが何をしてくれるのか、導入方法、渡すべき入力、そして苦手なことを説明します。掲載したコマンドはすべてリポジトリの README か SKILL.md からそのまま写したものです。ファイルは 2026 年 11 月 21 日に読みましたが、スキル自体は実行していないので、出力の説明はドキュメントに書かれている内容です。
スプライトスタッキングとは
スプライトスタックは、見下ろし視点の物体を床から上へ水平に輪切りにしたものです。食パンを底からスライスしていくイメージです。ゲームはこの層を下から順に描き、各層を同じ角度だけ回転させ、カメラの俯角に合わせて縦に少しつぶし、ひとつ下の層より 1 ピクセル上にずらします。見た目は滑らかに回る小さなボクセルモデルですが、中身はただの 2D 描画です。3D エンジンもメッシュも要らず、どの角度でもドットはくっきりしたままです。
README にもはっきり書かれているとおり、手法自体は新しいものではありません:「Sprite stacking is a long-standing indie game technique, not invented here.」このスキルが加えたのは、4 方向の図から立体を削り出す処理と、それをエージェントに任せるためのワークフローです。
スプライトスタッキングで一番大変なのはスライスを描く作業です。30 層の車なら、ぴったり揃った小さな画像を 30 枚描く必要があります。このスキルを使えばそこを飛ばせます。あなた(またはエージェント)が普通の 4 方向図を描けば、スクリプトがそこからスライスを削り出します。
スキルがやること
README では 4 つのステップで説明されています。
- ビュー: 上・横・正面・背面の 4 つの正投影図を 1 行に並べたシート。
- 削り出し: 4 つのビューすべてが覆っている場所にだけボクセルを残す。
- スライス: 削り出した立体を平たい層に切り分けて 1 本の帯にする。地面の層が先頭。
- 描画: 各層を回転し、俯角に合わせてつぶし、1 px ずつ持ち上げる。
スキルのフォルダには次のファイルが入っています。
SKILL.md:エージェントが読む指示書。良い 4 方向シートの作り方、スライス前のチェックリスト、スライサーのオプション、描画ループと具体的な数値、「完成の条件」チェックリスト、過去の失敗とその対策の表が載っています。scripts/views_to_slices.py:スライサー本体。背景を消し、各ビューを囲む 1px の輪郭線を取り除き、色をひとつの共通パレットにまとめ、スライスを削り出します。確認用の画像と単体で動くビューアーのページも書き出せます。scripts/viewer.html:ブラウザ用ビューアー。単体でも開けて、スライス画像をドロップして読み込めます。references/engines.md:Web の Canvas と React、Godot 4、Unity、そして Phaser や Pygame などへ組み込むための短いレシピ集。
Claude Code・Codex への導入
README のワンライナーは skills CLI を使います。Node 22.20 以降が必要です。
npx skills add danielwh2/sprite-stacking
これで現在のプロジェクトにスキルが入ります。README によると、-g を付けるとすべてのプロジェクト向けに、-a claude-code(または codex、cursor など)を付けると入れるエージェントを指定できます。
もうひとつの方法は、リポジトリの skills/sprite-stacking フォルダをエージェントのスキルフォルダにコピーすることです。
| エージェント | フォルダ |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex, Cursor, OpenCode, Gemini CLI, Pi | ~/.agents/skills/ |
スライサーは Python スクリプトなので、Pillow と NumPy を入れた Python 3 も必要です。README のコマンドは次のとおりです。
pip install pillow numpy
使い方:エージェントへの頼み方
スキル名を指定して呼び出す必要はありません。導入後は、作りたいものをそのまま頼めばエージェントが自分でスキルを使います。README の例は次のとおりです。
- 「Make a rotatable pixel art car.」(回転できるドット絵の車を作って)
- 「Sprite stack this 4-view sheet and give me a turntable.」(この 4 方向シートをスプライトスタックにして、ターンテーブルも見せて)
- 「Add a fake 3D pixel art tree to my Godot game.」(Godot のゲームに疑似 3D のドット絵の木を追加して)
SKILL.md は、渡されたものに応じてエージェントに進め方を選ばせます。
- スライス帯の PNG か MagicaVoxel のレイヤー書き出し: そのまま描画へ進む。
- 4 方向シート: まずシートをチェックしてから削り出す。
- プロンプトやアイデアだけ: 先に 4 方向シートを作り、それから削り出しと描画をする。
シートがない場合、エージェントが画像生成ツールを持っていれば、SKILL.md に用意されたプロンプトで生成します。持っていなければ、短い Python スクリプトで 4 方向のドット絵を自分で描きます。README の言葉では「No image generator? The agent draws the views itself in a short Python script.」です。
既存のゲームに組み込むときは、まずあなたのレンダラー(エンジン、ピクセル倍率、スプライトの描き方と並べ方)を読んでからスタックをそこに合わせるよう、SKILL.md は指示しています。2 つ目のキャンバスや描画パイプラインを追加することはしません。
必要な入力
4 方向シートには厳しいルールがあり、うまくいかない原因のほとんどはこれを守っていないことです。以下は SKILL.md からの要約です。
- TOP、SIDE、FRONT、BACK の順で 1 行に並べ、背景は真っ白、ビューの間ははっきり空ける。
- TOP は真上から見下ろし、物体の前を下に向ける。SIDE は前を左に向ける。
- 厳密な正投影。パースなし、傾きなし、斜め 45 度の見下ろし(3/4 ビュー)もなし。
- 4 つのビューで縮尺をそろえる。TOP の長さ=SIDE の長さ、TOP の幅=FRONT と BACK の幅、SIDE の高さ=FRONT と BACK の高さ。
- ベタ塗りの色面とくっきりした輪郭線。エアブラシ風のぼかしや 1px の細い内側の線は、スライスが回るとにじみます。スキルは無理に直すより描き直すよう勧めています。
サイズの目安も 3 段階で示されています。
- チャンキーなレトロ風: 15〜20 層、約 25×48 px、8〜10 倍で表示。
- 細密なハイビット: 26〜44 層、36×72〜46×107 px。通気口、ロゴ、スポークホイールまで描き込めます。
- ショーケース / 1080p 動画: 36〜56 層、30×30〜148×148 px、4〜6 倍で表示。
スライサーを自分で動かす
ふだんはエージェントがスライサーを実行しますが、README のコマンドでリポジトリのルートから自分で動かすこともできます。
python3 skills/sprite-stacking/scripts/views_to_slices.py views.png slices.png \
--slices 36 --preview check.png --html viewer.html
views.png が 4 方向シート、slices.png が書き出されるスライス帯です。README に載っているオプションは次のとおりです。
--slices N:層の数。チャンキーなら 15〜20、細密なら 32〜48。--order reading:TOP、SIDE、FRONT、BACK の順に強制する。デフォルトでは縦横比からビューを自動判定します。--round:塔、気球、鉢などを四角ではなく丸く削り出す。--side-nose right:SIDE ビューが右を向いているときに使う。--colours N:共通パレットの色数。0ですべての色を残す。--normals path.png:対応する法線マップのスライス帯も保存する。--emissive path.png:自動検出した発光マスク(ヘッドライト、窓、ネオン)も保存する。
SKILL.md にはほかにも、--top-nose(乗り物以外では down を渡す)、--shade、--bg-tol、--dark-thresh などが載っています。
check.png には、抽出された 4 つのビュー、ターンテーブルの 4 つの角度、分解図が並びます。スキルは、ゲームのコードを書く前に必ずこれを確認するようエージェントに指示しています。
ビューアー
--html は単体で動く Web ページを書き出します。README によると、ターンテーブル、手続き生成の小物が並ぶシーンモード、スライススキャン、分解図、そして WASD か矢印キーで車を走らせられるプレイモードがあります。ほかにも時間帯の切り替え、影を落とすドラッグ可能な太陽、雨と雪、16 方向の PNG スプライトシートを焼き出すエクスポートボタンも付いています。エンジン側が普通の方向別スプライトしか扱えない場合は、最後のエクスポートが便利です。
ゲームへの組み込み
描画ループはどの環境でも同じです。地面の層から順に、各スライスを中心で回転させ、y 方向を squash の値で縮め、層番号×spacing だけ持ち上げ、整数ピクセルにそろえて、最近傍補間で描きます。SKILL.md の既定値は spacing 1.0、斜め見下ろしのカメラなら squash 0.75(1.0 は真上から)です。references/engines.md には、すぐ使える Canvas 2D の関数と Godot 4 の Node2D スクリプトのほか、Unity(スライスごとに SpriteRenderer を 1 つ、Point フィルター)や Phaser、Pygame 向けのメモもあります。
見た目とパフォーマンスに効くアドバイスが 2 つあります。ひとつは、スタック全体を接地点で並べ替え、2 つの物体のスライスを交互に描かないこと。もうひとつは、動かないスタックはロード時に普通のスプライトへ焼き込んでおくことです。スキルによれば、30 層の木が 200 本あると 1 フレームで 6,000 回の描画になります。
制限
以下はスキル自身のチェックリストと失敗の表から拾ったものです。
- 隠れた空洞は埋まる。 削り出しは 4 つのシルエットすべてが覆う部分しか残さないので、どのビューにも映らないトラックの荷台やアーチの空洞は中身が詰まってしまいます。横から見て向こうが透けて見える張り出し(持ち上がったリアウイングなど)は残ります。空洞は削り出したあとに手で直すしかありません。
- 丸い部品は四角くなる。 TOP ビューにドットの円を描くか、丸い部分が土台より細い場合は
--roundを付ける必要があります。 - 1px の部品はちらつく。 回転につれて出たり消えたりします。柱、ロープ、アンテナは 2px 以上の太さで描いてください。スライサーが警告を出します。
- 出っ張りは棚になる。 壁から突き出たもの(フラワーボックスや看板)は、壁全体に沿った棚として削り出されます。小さなものは平面的に描き込みましょう。
- 閉じたすき間は埋まる。 ビューの内側に完全に囲まれた背景(脚の間、ひれの間、ロープの間)は物体の一部とみなされます。すき間は必ずビューの外までつながるようにします。
- 中心がずれた物体はぶれる。 スタックはバウンディングボックスの中心で回るので、物体はビューの中央に置きます。
- ドット絵専用。 この手法とスライサーは小さなベタ塗りのスプライト向けです。three.js や Unity の 3D ゲームで使う本物の 3D モデルを作る手段ではありません。
ライセンス
リポジトリは MIT ライセンス(Copyright 2026 Daniel White)で、GitHub の表示と LICENSE ファイルで確認できます。著作権表示とライセンス文をコードの複製に残せば、商用プロジェクトを含めて使用・改変・配布できます。このスキルで作ったスプライトのライセンスについて、README は何も述べていません。
よくある質問
スプライトスタッキングとは?
2D ゲームで 3D っぽく見せる手法です。物体を見下ろし視点の平たいスライスの帯として持ち、ゲームが下から順に、同じ角度だけ回転させつつ 1 ピクセルずつ持ち上げて描きます。回転する小さなボクセルモデルのように見えますが、くっきりしたドット絵のままです。
sprite-stacking スキルは無料ですか?
無料です。MIT ライセンスのオープンソースです。必要なのは Pillow と NumPy を入れた Python 3 で、npx skills で入れる場合は Node 22.20 以降も必要です。AI エージェントのサブスクリプションや API 利用料は別にかかります。
Claude Code と Codex で使えますか?
使えます。README に両方とも載っています。npx skills add danielwh2/sprite-stacking で導入するか(エージェント指定は -a claude-code または -a codex)、skills/sprite-stacking を Claude Code なら ~/.claude/skills/、Codex なら ~/.agents/skills/ にコピーします。
画像生成ツールは必要ですか?
必要ありません。エージェントが画像生成ツールを持っていれば、スキルが 4 方向シート用のプロンプトを渡します。持っていなければ、エージェントが短い Python スクリプトで自分で描きます。自分で描いたシート、スライス帯、MagicaVoxel のレイヤー書き出しを渡すこともできます。
結果は Godot、Unity、Phaser で使えますか?
使えます。references/engines.md には Godot 4 のスクリプト、Unity 向けのメモ、Web と React 用の Canvas 2D 関数、Phaser や Pygame で使える汎用ループが載っています。ビューアーからは、普通のスプライトしか扱わないエンジン向けに 16 方向の PNG スプライトシートも書き出せます。
スプライトの一部が詰まったり四角くなったりするのはなぜ?
スライサーは 4 つのビューすべてが覆う場所にしかボクセルを残さないからです。どのビューにも見えない空洞は埋まり、丸い部品には TOP ビューの円か --round オプションが必要で、ビュー内で完全に囲まれたすき間も埋まります。対処法は上の「制限」にまとめています。
関連ガイド
- ゲーム開発向けエージェントスキルと MCP サーバー:Godot、Unity、three.js、ドット絵、スプライト向けのスキルをさらに紹介。
- Blender MCP:スプライトスタックではなく本物の 3D モデルが必要なときに。
- Polyfork の無料 3D モデル:three.js ゲーム向けの無料ローポリ GLB。
出典
2026 年 11 月 21 日に確認:danielwh2/sprite-stacking README、SKILL.md、references/engines.md、LICENSE、GitHub 上のリポジトリ情報(作成日 2026 年 11 月 20 日、2026 年 11 月 21 日時点で 187 スター)。
スプライトスタックの車や小物を使ったゲームを作ったら、VibeGamer に投稿してください。



