Sprite Gen
AI 원화를 투명 프레임·애니메이션 아틀라스·manifest로 굽는 에이전트 스킬
python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py --repo aldegad/sprite-gen --path .기준 캐릭터 이미지에서 상태별 행 이미지를 생성한 뒤 크로마 제거, 연결 컴포넌트 분리, 픽셀 격자 정렬, 셀 배치와 manifest 생성을 결정론적으로 수행하는 Codex·Claude용 스프라이트 파이프라인입니다. 원시 생성 이미지를 곧바로 최종 에셋으로 취급하지 않고 추출·검사·점수·수정 루프를 거치며, 웹 큐레이션 화면에서 프레임 선택·순서·위치·회전·호흡 효과를 확인하고 최종 아틀라스와 GIF를 내보냅니다. 생성 단계는 Codex 또는 Grok 공급자 CLI의 인증과 모델 이용 조건을 별도로 따릅니다.
판단
이럴 때 씁니다
- 한 캐릭터의 여러 상태를 일관된 투명 셀과 런타임 manifest로 만들어야 할 때
- 생성 이미지 뒤에 결정론적 알파·추출·검수·큐레이션 단계가 필요할 때
- 완성된 시트나 낱장 PNG 묶음을 다시 잘라 비교·선택·내보낼 때
이럴 땐 쓰지 마세요
- 픽셀 아트를 프레임별로 직접 그리는 수작업 편집기가 필요한 경우
- Codex·Grok 등 이미지 생성 공급자 인증을 사용할 수 없는 환경
- 기준 캐릭터 이미지가 아직 정체성·비율·방향 기준을 충족하지 못한 상태
차별점
- AI 생성은 raw 이미지 단계에만 두고 최종 프레임은 같은 입력에 같은 출력을 내는 Python 변환으로 만듭니다.
- 크로마 제거·컴포넌트 추출·피치 검출·셀 배치와 프레임 manifest를 한 파이프라인으로 묶습니다.
- 웹 큐레이션에서 선택·순서·변환·호흡·색상 변형을 확인한 뒤 아틀라스와 GIF로 굽습니다.
워크플로
- 01v1.59.0 태그를 고정해 스킬을 설치하고 Python 3.10 이상 격리 환경을 준비합니다.
- 02최종 비율과 정체성이 맞는 base idle을 사람 검수로 잠근 뒤 run 디렉터리를 만듭니다.
- 03공급자 CLI로 상태 행을 생성하고 extract·inspect·score 경로로 알파와 프레임 수를 검증합니다.
- 04큐레이션 화면에서 프레임을 선택한 뒤 atlas·manifest·GIF를 굽고 실제 게임에서 좌표를 재검증합니다.
주요 명령
| 명령 | 설명 |
|---|---|
python3 scripts/prepare_sprite_run.py --out-dir <run-dir> --character-id <id> --base-image base.png | 요청 원본, 레이아웃 가이드, 프롬프트와 빈 실행 폴더를 만듭니다. |
python3 scripts/extract_sprite_row_frames.py --run-dir <run-dir> | 생성된 상태 행에서 투명 프레임을 추출하고 manifest를 기록합니다. |
python3 scripts/serve_curation.py --run-dir <run-dir> | 브라우저 큐레이션 화면에서 프레임을 비교·선택·조정합니다. |
python3 scripts/compose_sprite_atlas.py --run-dir <run-dir> | 선택 결과를 최종 아틀라스와 런타임 frame_layout으로 굽습니다. |
함정
설치 전에 확인하세요
- Codex·Grok 생성 공급자는 별도 CLI와 해당 계정 인증이 필요하며 사용량·데이터 처리는 각 공급자 조건을 따릅니다.
- 기준 idle 이미지의 비율·스타일·정체성이 약하면 이후 모든 상태 행에서 드리프트가 누적됩니다.
- 원시 행을 단순 축소해 최종 에셋으로 쓰는 경로는 프로젝트의 픽셀 정렬·알파 품질 계약을 통과하지 못합니다.
- Python 패키지 레지스트리 배포가 아니라 GitHub 스킬 설치 방식이므로 태그를 고정하고 설치 스크립트를 검토해야 합니다.
비교
일반 이미지 생성 스킬이 낱장 결과를 만드는 데서 끝난다면 Sprite Gen은 게임 런타임이 읽을 셀 좌표와 프레임 순서를 manifest로 남기는 후처리·검수 계층까지 포함합니다. Aseprite처럼 사람이 직접 픽셀을 그리는 편집기는 아니며, 생성 품질이 낮으면 자동 파이프라인만으로 캐릭터 일관성을 보장할 수 없습니다.
최근 변경
v1.59.0은 외부 기여를 통합한 릴리스로, CLI 도움말·색상 동작을 결정적으로 정리하고 Aseprite·Phaser·Flame 내보내기 형식을 추가했습니다. 캐릭터·이펙트 실행에는 해상도 인식 subject profile이 들어갔고 Windows provider 및 shared-lock 호환성도 보강됐습니다.