Agent Sprite Forge: 원화 한 장으로 게임용 스프라이트를 만드는 스킬 모음
캐릭터 원화 한 장에서 동작별 영상을 만들고, 이를 투명 프레임·스프라이트 시트·게임 엔진용 패키지로 정리하는 AI 에이전트 스킬 모음이에요. 맵·타일·효과 제작도 다루며, 확인한 플러그인 버전은 0.4.0예요.
주요 기능
- generate2dsprite로 캐릭터 원화 후보를 만든 뒤 사용자가 선택한 원화를 master.json으로 기록해요. 아이콘·소품·효과에는 시트 기반 제작 흐름도 제공해요.
- video2dsprite의 sprite_set.py가 원화에서 idle·walk·run·attack·jump·hurt 같은 동작별 영상 생성을 계획하고, 키잉·정렬·루프 선택·원샷 리타이밍·검토·패키징을 이어갑니다.
- 기본 HD 마무리와 선택적 픽셀 마무리를 구분해요. 픽셀 마무리는 제한 팔레트·이진 알파·선택적 외곽선 등을 적용하고, 컬러 락은 원화 기준의 색상 변화를 줄이도록 설계되어 있어요.
- animation.json 3.0, PNG 아틀라스, 알파 WebM 및 packed-alpha MP4를 출력하며 Godot SpriteFrames·Sprite3D와 Aseprite JSON 내보내기를 제공해요. 내보내기 기능의 존재와 에디터 실제 가져오기 검증은 구분해야 해요.
- generate2dmap은 레이어 맵·타일·소품·패럴랙스·충돌/이동 데이터와 Tiled·Godot·LDtk 출력을 다룹니다. generate2dmedia가 미디어 생성 경로를 선택하며 codeart2d는 명시 요청 또는 생성 경로가 없을 때의 코드 아트 대안이에요.
구조
다섯 개의 skills 폴더, 공통 Python 모듈·JSON 스키마를 담은 shared, 설치·동기화 도구, 테스트·검증 문서로 구성돼요. Claude Code는 .claude-plugin 매니페스트를 사용하고 Codex·Grok은 스킬 폴더를 설치해요. 생성은 외부 모델 또는 로그인된 CLI가 담당하고, Python 후처리 도구는 프레임·알파·정렬·타이밍·출력 계약을 처리해요. 스킬 간 상대 경로 참조가 있어 다섯 폴더를 함께 유지하도록 공식 문서가 안내해요.
누구에게 쓸모 있나요
2D 게임 캐릭터·배경·효과의 초안을 AI 에이전트와 만들고, 수작업 검수 후 Godot·웹 게임 등에 통합하려는 개발자와 테크니컬 아티스트에게 적합해요. 완성 에셋의 품질과 엔진 호환성을 자동 보증하는 도구는 아니에요.
설치 전 준비
- Python 3.10 이상과 numpy>=1.26, Pillow>=10.1, scipy>=1.11을 요구해요. 공식 문서는 scipy가 가속용이며 numpy 대체 경로가 있다고 설명해요.
- 영상 처리·스프라이트 세트·영상 패키징에는 PATH에 ffmpeg 5.1 이상과 libvpx-vp9·libx264 지원이 필요해요.
- 이미지·영상 생성에는 지원 제공자의 API 키 또는 사용자가 로그인한 Codex/Grok CLI 중 적절한 경로가 필요해요. Codex의 이미지 경로와 Grok의 영상 경로는 서로 달라요.
- codeart2d의 SVG 렌더링은 선택적으로 resvg-py 등 추가 도구가 필요하며, JavaScript 런타임·일부 검증에는 Node.js 22가 사용돼요.
- Claude Code 플러그인, Codex 및 Grok 스킬. 사용자 홈 또는 지정 스킬 폴더에 설치해요.
- 개발·실측 환경은 공식 기록상 Windows 11예요. Linux·macOS 경로가 문서화되어 있으나 해당 OS에서 전체 테스트를 실행했다는 근거는 없어요.
- 출력 대상은 Godot 4, Aseprite·Phaser·PixiJS 및 웹, 맵은 Tiled 1.10·Godot 4.3+·LDtk 1.5.3예요. 실제 대상 에디터/기기 검증은 별도로 필요해요.
설치 방법
Claude Code 플러그인
공식 README의 설치 예시예요. sparse 옵션은 쇼케이스 미디어 대신 플러그인과 스킬을 받습니다. 여기서는 설치하거나 실행하지 않았어요.
claude plugin marketplace add 0x0funky/agent-sprite-forge --sparse .claude-plugin skills
claude plugin install agent-sprite-forge@agent-sprite-forge
python -m pip install "numpy>=1.26" "Pillow>=10.1" "scipy>=1.11"Codex 스킬
공식 예시의 clone은 실행 시점의 최신 소스를 받으므로 아래 조사 커밋과 일치하는지 확인해야 해요. –apply는 기존 설치를 백업한 뒤 사용자 범위 스킬을 교체해요.
git clone https://github.com/0x0funky/agent-sprite-forge.git
cd agent-sprite-forge
python -m pip install -r requirements.txt
python tools/install_skills.py --apply --host codexGrok 또는 다른 스킬 폴더
같은 저장소에서 호스트를 선택해요. –host agents는 ~/.agents/skills에 쓰며 –dest로 다른 경로를 지정할 수 있어요. 설치 범위와 기존 스킬 백업을 먼저 확인해요.
python tools/install_skills.py --apply --host grok설치본 변경 확인
소스와 설치본의 누락·변경·추가 파일을 비교해요. 검사 통과가 보안성·실제 호스트 호환성을 보장하지는 않습니다. 설치 후 새 에이전트 세션에서 스킬을 불러옵니다.
python tools/install_skills.py --check --host codex사용 방법
- 먼저 캐릭터의 소유권·모양·시점·방향·HD 또는 픽셀 스타일, 프레임 크기와 출력 엔진을 명시해요. $generate2dsprite로 원화 후보를 만들고 사람이 승인해요.
- 승인된 master.json을 기준으로 $video2dsprite에 필요한 동작과 길이·루프 여부를 요청해요. 계획 → 실행 → 리뷰 시트 → 동작별 승인 → 보고서 흐름으로 확인해요.
- 숫자 QC와 별개로 얼굴·무기·손발·정체성·가림·움직임을 직접 확인해요. 달리기와 점프는 재생성될 수 있으므로 호출 수와 비용 한도를 먼저 지정해요.
- 맵은 $generate2dmap으로 생성하고 충돌·이동 가능 영역의 디버그 화면을 실제 그림과 대조해요. 내보낸 파일은 별도 테스트 프로젝트에서 에디터 가져오기·재생·충돌을 검증해요.
- 실제 생성 전에 route_media.py의 resolve 또는 –dry-run으로 예정 경로를 확인하고, .forge/ledger.jsonl 및 출력별 job.json으로 사용량·작업 ID·출처를 점검하는 절차를 권장해요.
비용과 API 키
저장소 코드·문서는 MIT예요. 외부 이미지/영상 API 요금 또는 Codex·Grok 구독 할당량은 별도예요. 기본 비용·호출 상한이 없으며 –budget-usd, –max-calls, FORGE_MAX_PAID_REQUESTS 등의 제한은 사용자가 설정해야 해요. 공식 제한 문서는 가격 행이 실시간 조회가 아니며 OpenAI 이미지 모델의 검증된 가격 행이 없어 –budget-usd가 해당 경로를 거부한다고 설명해요. 현재 제공자별 모델·가격·약관은 이번 조사에서 별도로 검증하지 않았어요.
라이선스
MIT License, Copyright (c) 2026 0x0funky. 코드·문서 복제 또는 상당 부분의 배포 시 저작권·허가 고지를 유지해야 하며 무보증이에요. 공식 README는 생성한 이미지·영상이 이 MIT 허가의 적용 대상이 아니며 각 생성 제공자의 약관을 따른다고 명시해요. 기존 캐릭터·실존 인물·참조 이미지의 권리도 별도로 확인하고 상업용은 소유하거나 이용 권한이 있는 IP를 사용해야 해요.
주의사항과 알려진 이슈
- 공식 라우터는 설정된 API 키를 호출 동의로 간주하여 자동 전송하는 설계예요. 이것이 사용자의 포괄적 비용·데이터 전송 승인을 뜻하지는 않습니다. 제공자·참조 이미지·프롬프트·예산을 사전에 지정해야 해요.
- 설치 도구는 사용자 스킬 폴더를 쓰고 기존 설치를 백업·교체해요. 점 파일 등을 제외한 미추적 파일도 복사하므로 깨끗하고 확인된 소스에서 설치해야 해요. 키를 저장소·명령 인자·공유 로그에 넣지 않아야 해요.
- Godot·LDtk·Aseprite 등은 공식 문서상 파싱 수준 검증이며 실제 에디터 가져오기는 미검증이에요. Tiled도 내장 리더 재렌더링 검증이지 GUI 확인은 아니에요. Godot 맵 출력에는 조명·카메라·일부 애니메이션 등 누락 항목이 있어요.
- 일부 영상 품질 임계값은 제한된 실제 샘플과 합성 테스트에 기반해요. 빠른 팔다리·점프의 정체성 변화, 키 색과 비슷한 의상 소실, 경계 잔상·깜빡임이 남을 수 있으며 자동 QC가 시각 품질을 승인하지 않습니다.
- 동영상은 ffmpeg 디코딩과 제한적인 헤드리스 브라우저에서 검증됐다고 기록되어 있어요. 실제 GPU·Safari·iPhone 동작은 미검증이며 packed-alpha MP4는 일반 투명 MP4가 아니에요.
- 공식 검증 기록은 작성자 로컬 실행 결과예요. 저장소에 CI가 없다고 명시하며 Linux·macOS, 최소 numpy/Pillow 버전, 모든 제공자 경로를 검증한 결과로 확대 해석하면 안 돼요.
- 모델·CLI·요금표와 스킬은 변할 수 있어요. 설치 명령은 고정 커밋 설치가 아니며 공급망·권한·호환성과 외부 서비스 조건을 도입 시점에 다시 확인해야 해요.
확인 범위
확인 날짜: 2026-11-05
확인 커밋: 5324342fdfab72430f4e9604f3fe427009f8596d
확인한 범위: 공식 GitHub로 canonical 0x0funky/agent-sprite-forge, 공개·비보관 상태, 기본 main과 관측 커밋을 확인했어요. 고정 커밋의 영문·한국어 README, MIT LICENSE, 0.4.0 플러그인 매니페스트, 의존성, 알려진 제한과 검증 기록, 설치 및 미디어 라우팅 코드 일부를 읽은 정적 검토예요.
확인 한계: 대상 저장소 설치·코드 실행·스킬 활성화·모델/API 호출·에셋 생성·에디터 가져오기·보안 감사를 수행하지 않았어요. 전체 스크립트·모든 제공자 모델·현재 요금·마켓플레이스 배포본 일치는 미검증이에요. 공개 이슈를 별도로 조사하지 않았으며 issues 빈 배열은 문제가 없다는 뜻이 아니에요.