sprite-stacking은 Daniel White가 만든 오픈소스 에이전트 스킬입니다. 물체를 네 방향(위, 옆, 앞, 뒤)에서 그린 픽셀 아트를 주면 "스프라이트 스택"을 만들어 줍니다. 스프라이트 스택은 납작한 슬라이스를 한 줄로 이어 붙인 이미지로, 게임에서 이 슬라이스를 겹쳐 그리면 돌려 볼 수 있는 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." 이 스킬이 더한 것은 네 방향 뷰로 입체를 깎아 내는 과정과 이를 에이전트에게 맡기는 워크플로입니다.

스프라이트 스태킹에서 가장 고된 일은 슬라이스를 그리는 것입니다. 30층짜리 자동차라면 정확히 맞물리는 작은 이미지 30장이 필요합니다. 이 스킬은 그 단계를 건너뛰게 해 줍니다. 여러분(또는 에이전트)이 평범한 네 방향 뷰만 그리면 스크립트가 거기서 슬라이스를 깎아 냅니다.

스킬이 하는 일

README는 과정을 네 단계로 설명합니다.

  1. 뷰: 위, 옆, 앞, 뒤 네 개의 정투영 뷰를 한 줄로 놓은 시트.
  2. 깎기: 네 뷰가 모두 덮는 곳에만 복셀을 남긴다.
  3. 슬라이스: 깎아 낸 부피를 납작한 층으로 잘라 한 줄의 띠로 만든다. 바닥 층이 맨 앞.
  4. 렌더링: 각 층을 회전하고, 기울기에 맞게 누르고, 1px씩 올린다.

스킬 폴더에는 다음이 들어 있습니다.

  • SKILL.md: 에이전트가 읽는 지침서. 좋은 네 방향 시트를 얻는 법, 슬라이스 전 점검 목록, 슬라이서 옵션, 렌더링 루프와 구체적인 수치, "완료 조건" 체크리스트, 지금까지의 실수와 해결책을 정리한 표가 있습니다.
  • scripts/views_to_slices.py: 슬라이서. 배경을 지우고, 각 뷰를 두른 1px 외곽선을 걷어 내고, 색을 하나의 공유 팔레트로 줄이고, 슬라이스를 깎아 냅니다. 확인용 이미지와 단독으로 열리는 뷰어 페이지도 만들 수 있습니다.
  • scripts/viewer.html: 브라우저 뷰어. 따로 열어서 슬라이스 띠를 끌어다 놓을 수도 있습니다.
  • references/engines.md: 웹 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."(이 네 방향 시트를 스프라이트 스택으로 만들고 턴테이블도 보여 줘.)
  • "Add a fake 3D pixel art tree to my Godot game."(내 Godot 게임에 가짜 3D 픽셀 아트 나무를 넣어 줘.)

SKILL.md는 무엇을 받았는지에 따라 에이전트가 경로를 고르게 합니다.

  • 슬라이스 띠 PNG나 MagicaVoxel 레이어 내보내기: 바로 렌더링으로 넘어갑니다.
  • 네 방향 시트: 시트를 점검한 뒤 깎아 냅니다.
  • 프롬프트나 아이디어만: 먼저 네 방향 시트를 만든 다음 깎고 렌더링합니다.

시트가 없을 때 에이전트에게 이미지 생성 도구가 있으면 SKILL.md에 적힌 프롬프트로 시트를 만듭니다. 없으면 짧은 Python 스크립트로 네 방향을 직접 픽셀 아트로 그립니다. README의 표현으로는 "No image generator? The agent draws the views itself in a short Python script."입니다.

기존 게임에 넣을 때는 먼저 렌더러(엔진, 픽셀 배율, 스프라이트를 그리고 정렬하는 방식)를 읽고 스택을 거기에 맞추라고 SKILL.md가 지시합니다. 두 번째 캔버스나 렌더링 파이프라인을 새로 만들지 않습니다.

필요한 입력

네 방향 시트에는 엄격한 규칙이 있고, 결과가 나쁜 경우는 대부분 이 규칙을 어겼을 때입니다. SKILL.md의 내용을 정리하면 다음과 같습니다.

  • TOP, SIDE, FRONT, BACK 순서로 한 줄, 흰 단색 배경, 뷰 사이에는 넉넉한 간격.
  • TOP은 바로 위에서 내려다보고 물체의 앞쪽이 아래를 향합니다. SIDE는 앞쪽이 왼쪽을 향합니다.
  • 엄격한 정투영: 원근 없음, 기울임 없음, 3/4 시점 없음.
  • 네 뷰의 축척이 같아야 합니다. TOP 길이 = SIDE 길이, TOP 너비 = FRONT·BACK 너비, SIDE 높이 = FRONT·BACK 높이.
  • 평평한 색 면과 또렷한 외곽선. 에어브러시처럼 부드러운 가장자리나 1px짜리 가는 안쪽 선은 슬라이스가 회전하면 번집니다. 스킬은 살리려 애쓰기보다 다시 그리라고 권합니다.

크기도 세 단계로 안내합니다.

  • 큼직한 레트로: 1520층, 약 25×48px, 810배로 표시.
  • 정밀한 하이비트: 2644층, 36×7246×107px. 통풍구, 로고, 스포크 휠까지 담을 수 있습니다.
  • 쇼케이스 / 1080p 영상: 3656층, 30×30148×148px, 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는 네 방향 시트, slices.png는 출력될 슬라이스 띠입니다. README에 나온 옵션은 다음과 같습니다.

  • --slices N: 층 수. 큼직한 스타일은 1520, 정밀한 스타일은 3248.
  • --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에는 추출된 네 뷰, 턴테이블 네 각도, 분해도가 담깁니다. 스킬은 게임 코드를 쓰기 전에 이 이미지부터 확인하라고 에이전트에게 지시합니다.

뷰어

--html은 단독으로 열리는 웹 페이지를 만듭니다. 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 하나, Point 필터)와 Phaser, Pygame에 대한 메모도 있습니다.

성능과 겉모습에 중요한 팁이 두 가지 있습니다. 하나는 스택 전체를 바닥 접점 기준으로 정렬하고, 두 물체의 슬라이스를 섞어 그리지 않는 것입니다. 다른 하나는 움직이지 않는 스택을 게임 로딩 때 일반 스프라이트로 구워 두는 것입니다. 스킬에 따르면 30층짜리 나무 200그루는 한 프레임에 6,000번을 그려야 합니다.

한계

다음은 스킬 자체의 체크리스트와 실수 기록표에서 가져온 내용입니다.

  • 숨은 빈 공간은 채워집니다. 깎기는 네 실루엣이 모두 덮는 부분만 남기므로, 어느 뷰에도 드러나지 않는 트럭 짐칸이나 속이 빈 아치는 꽉 찬 덩어리가 됩니다. 옆에서 볼 때 뒤가 비쳐 보이는 돌출부(들려 있는 리어 윙 등)는 남습니다. 빈 공간은 깎은 뒤 손으로 고쳐야 합니다.
  • 둥근 부품은 네모로 깎입니다. 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/에 복사하면 됩니다.

이미지 생성 도구가 꼭 있어야 하나요?

아니요. 에이전트에게 이미지 생성 도구가 있으면 스킬이 네 방향 시트용 프롬프트를 줍니다. 없으면 에이전트가 짧은 Python 스크립트로 직접 그립니다. 직접 그린 시트, 슬라이스 띠, MagicaVoxel 레이어 내보내기를 넘겨도 됩니다.

결과물을 Godot, Unity, Phaser에서 쓸 수 있나요?

네. references/engines.md에 Godot 4 스크립트, Unity 메모, 웹과 React용 Canvas 2D 함수, Phaser와 Pygame에 쓸 수 있는 일반 루프가 있습니다. 뷰어에서는 일반 스프라이트만 쓰는 엔진을 위해 16방향 PNG 스프라이트 시트도 내보낼 수 있습니다.

스프라이트 일부가 꽉 차거나 네모나게 나오는 이유는?

슬라이서가 네 뷰가 모두 덮는 곳에만 복셀을 남기기 때문입니다. 어느 뷰에서도 안 보이는 빈 공간은 채워지고, 둥근 부품에는 TOP 뷰의 원이나 --round 옵션이 필요하며, 뷰 안에 완전히 갇힌 틈도 메워집니다. 해결법은 위의 "한계" 항목에 정리해 두었습니다.

관련 가이드

출처

2026년 11월 21일 확인: danielwh2/sprite-stacking README, SKILL.md, references/engines.md, LICENSE, GitHub 저장소 정보(2026년 11월 20일 생성, 2026년 11월 21일 기준 스타 187개).

스프라이트 스택 자동차나 소품으로 게임을 만들었다면 VibeGamer에 제출해 주세요.