[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6PHCTMBPTG56KMK8VH5SCTE":3,"skill-same:01M6PHCTMBPTG56KMK8VH5SCTE":54},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":27,"linkOnly":28,"markdownContent":29,"markdownBody":30,"frontMatter":31,"refName":33,"commitSha":34,"skillDirectory":35,"forksCount":36,"repositoryHtmlUrl":37,"repositoryHomepageUrl":6,"ownerHtmlUrl":38,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":39,"install":40,"resources":53},"01M6PHCTMBPTG56KMK8VH5SCTE","generate-spritesheet",null,"Gemini 이미지 생성으로 게임용 아이콘 스프라이트시트를 만들고 자동 슬라이스한다. 아이콘, UI 리소스, 뱃지, 마커 등 여러 개의 동일 카테고리 에셋이 필요할 때 사용한다.","DevelopmentDummy\u002Fclaude-play","DevelopmentDummy","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F269318128?v=4","01M6PH7WG74ND790ED9698KRBP","01M6PH7WM7KC9N0V51ZCQ43P8B",3,"MIT","https:\u002F\u002Fgithub.com\u002FDevelopmentDummy\u002Fclaude-play\u002Fblob\u002Fmain\u002Fdata\u002Ftools\u002Fgemini\u002Fskills\u002Fgenerate-spritesheet\u002FSKILL.md",[],[18,19,20,21,22,23,24,25,26],"generate","generate spritesheet","gemini","ui","Bash","read","write","edit","이미지","2026-11-10 10:12:30",false,"---\nname: generate-spritesheet\ndescription: Gemini 이미지 생성으로 게임용 아이콘 스프라이트시트를 만들고 자동 슬라이스한다. 아이콘, UI 리소스, 뱃지, 마커 등 여러 개의 동일 카테고리 에셋이 필요할 때 사용한다.\nallowed-tools: Bash, Read, Write, Edit\n---\n\n# 스프라이트시트 생성 (Gemini + PIL 슬라이스)\n\nGemini 이미지 생성 1회로 N×M 그리드 스프라이트시트를 만들고, Python PIL로 개별 아이콘을 자동 추출한다.\n\n## 파이프라인\n\n```\n1. 프롬프트 설계 (N×M 그리드, 아이콘 목록)\n2. Gemini API 호출 (1장 생성)\n3. 생성 대기 (15-20초)\n4. 생성된 이미지를 직접 확인하여 실제 그리드 크기 파악 (중요!)\n5. Python PIL 슬라이스 (그리드 분할 → 배경 자동 감지 → 크롭 → 정규화 → 배경 제거)\n6. 결과 검증\n```\n\n## 1단계: 프롬프트 설계\n\n### 프롬프트 템플릿\n\n```\nA {cols}x{rows} grid of {카테고리} on a pure black background.\n{총 수} icons arranged in a strictly aligned {cols} columns by {rows} rows grid.\nEach icon must be inside its own clearly separated rectangular cell.\n{스타일 지시}\n\nRow 1 (left to right): {아이템1}, {아이템2}, ...\nRow 2: ...\n...\n\nEach icon should be {품질\u002F스타일 요구사항}.\n```\n\n### 프롬프트 강화 규칙\n\nGemini는 그리드를 자의적으로 해석하는 경향이 있다. 다음 문구를 반드시 포함하여 정규 그리드를 강제한다:\n\n- **그리드 강제**: `\"strictly aligned {cols} columns by {rows} rows grid\"` — \"perfect\" 대신 \"strictly aligned\" 사용\n- **셀 분리 강제**: `\"Each icon must be inside its own clearly separated rectangular cell\"` — 아이콘 간 겹침 방지\n- **배경색 명시**: `\"on a pure black background\"` — 슬라이서가 배경색을 기준으로 동작\n- **정확한 수량 반복**: 프롬프트 첫 줄과 구조 설명 줄에 모두 그리드 크기를 명시\n\n### 주의: Gemini의 그리드 불일치 문제\n\n**Gemini는 요청한 그리드 크기와 다른 결과를 생성할 수 있다.** 예를 들어:\n- 4×4(16개) 요청 → 6×4(24개) 생성\n- 4×3(12개) 요청 → 6×3(18개) 생성\n- 배경색을 검정 대신 흰색으로 생성\n\n**따라서 3단계에서 반드시 이미지를 직접 열어 확인하고, 실제 그리드 크기를 파악한 후 슬라이스해야 한다.**\n\n### 프롬프트 작성 규칙\n\n- 반드시 **영어**로 작성\n- `pure black background` 명시 (배경 제거 기준)\n- 각 Row의 아이콘을 **왼쪽에서 오른쪽 순서로** 구체적으로 나열\n- 스타일 통일 문구 포함: `flat design`, `golden outlines`, `game UI style` 등\n- 최대 권장 요청: **4×4 (16개)** — 실제로 더 많이 생성될 수 있지만 품질 유지됨\n- 텍스트 라벨 방지: `\"no text labels\"` 추가 권장 (Gemini가 아이콘에 이름을 적는 경향 있음)\n\n### 프롬프트 예시\n\n무기 아이콘:\n```\nA 4x4 grid of medieval fantasy RPG weapon icons on a pure black background.\n16 weapon icons arranged in a strictly aligned 4 columns by 4 rows grid.\nEach icon must be inside its own clearly separated rectangular cell.\nFlat design, golden metallic outlines, dark background per icon, game UI style, no text labels.\n\nRow 1 (left to right): iron sword, ornate steel sword, glowing enchanted blade, great sword\nRow 2: dagger, curved assassin blade, hunting bow, longbow\nRow 3: wooden staff, crystal magic staff with purple glow, battle axe, war hammer\nRow 4: spear, halberd, throwing knives, magic wand\n\nEach icon centered in its cell, recognizable silhouette, suitable for inventory UI.\n```\n\n클래스 엠블럼:\n```\nA 4x4 grid of medieval fantasy RPG class emblem icons on a pure black background.\n16 class emblems arranged in a strictly aligned 4 columns by 4 rows grid.\nEach emblem must be inside its own clearly separated rectangular cell.\nRich colors, metallic gold borders, heraldic style, game UI quality, no text labels.\n\nRow 1 (left to right): crossed swords on red shield (Fighter), silver sword and cross on blue (Knight), flaming axe on black (Berserker), bow and arrow on green crest (Ranger)\nRow 2: healing staff on green (Healer), crescent moon and stars on purple (Enchantress), musical note on pink ribbon (Dancer\u002FBard), spear and shield on gray (Soldier)\nRow 3: lance on crimson dragon crest (Dragoon), twin daggers on dark shadow (Thief), holy sun rays on gold (Sage), dark skull on purple flames (Dark Knight)\nRow 4: crown on royal blue (General), treasure chest on amber (Treasure Hunter), shuriken on midnight blue (Ninja), crystal ball on purple (Arcane Mage)\n\nEach emblem should look like a heraldic badge, ornate and detailed.\n```\n\n상태효과:\n```\nA 4x3 grid of RPG status effect icons on a pure black background.\n12 status effect icons in a strictly aligned 4 columns by 3 rows grid.\nEach icon must be inside its own clearly separated rectangular cell.\nClean bold design, glowing effects, game battle UI style, no text labels.\n\nRow 1 (left to right): red upward arrow (ATK buff), blue upward arrow (DEF buff), green healing sparkles (regeneration), golden aura rays (all stats boost)\nRow 2: red downward arrow (ATK debuff), blue downward arrow (DEF debuff), purple skull with drip (poison), orange flame (burn)\nRow 3: ice crystal snowflake (frozen), yellow lightning (stun), pink swirl hearts (charm), green shield bubble (barrier)\n\nEach icon vibrant, immediately recognizable at small sizes.\n```\n\n## 2단계: Gemini 호출\n\n```bash\ncat > \u002Ftmp\u002Fgemini-sprite.json \u003C\u003C 'REQEOF'\n{\n  \"prompt\": \"\u003C설계한 프롬프트>\",\n  \"filename\": \"\u003C카테고리>-sprite.png\",\n  \"persona\": \"\u003C페르소나 이름>\"\n}\nREQEOF\ncurl -s -X POST \"http:\u002F\u002Flocalhost:{{PORT}}\u002Fapi\u002Ftools\u002Fgemini\u002Fgenerate\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d @\u002Ftmp\u002Fgemini-sprite.json\n```\n\n또는 MCP 도구:\n```\nmcp__claude_play__gemini_generate({\n  prompt: \"...\",\n  filename: \"weapons-sprite.png\",\n  persona: \"페르소나이름\"\n})\n```\n\n## 3단계: 생성 확인 + 실제 그리드 파악 (중요!)\n\n```bash\nsleep 15 && ls -la \"\u003C페르소나경로>\u002Fimages\u002F\u003C파일명>\"\n```\n\n**반드시 이미지를 직접 열어서 실제 그리드 크기를 확인한다:**\n\n```\nRead 도구로 이미지를 열어 확인\n```\n\n확인할 사항:\n1. **실제 행×열 수**: 요청한 것과 다를 수 있다 (예: 4×4 요청 → 6×4 생성)\n2. **배경색**: 검정인지 흰색인지 확인 — 슬라이서 모드 결정에 필요\n3. **텍스트 라벨 유무**: 라벨이 포함됐으면 슬라이싱에 영향 줄 수 있음\n4. **아이콘 배치 균일성**: 그리드가 대체로 균일한지\n\n**이 확인 없이 슬라이스하면 아이콘이 잘리거나 병합된다.**\n\n## 4단계: Python PIL 슬라이스 + 배경 제거 (통합)\n\n슬라이스와 배경 제거를 한 번에 처리하는 통합 스크립트. **3단계에서 확인한 실제 그리드 크기와 배경색을 반영하여 설정값을 조정한다.**\n\n```python\npython -c \"\nfrom PIL import Image\nimport os, shutil\n\n# ── 설정 (3단계 확인 결과에 맞게 수정) ───────────\nINPUT = '\u003C페르소나경로>\u002Fimages\u002F\u003C카테고리>-sprite.png'\nOUTPUT = '\u003C페르소나경로>\u002Fimages\u002Ficons\u002F\u003C카테고리>'\nCOLS = 4        # 실제 열 수 (이미지 확인 후 조정!)\nROWS = 4        # 실제 행 수 (이미지 확인 후 조정!)\nICON_SIZE = 64  # 출력 아이콘 크기 (px)\nBG = 'black'    # 배경색: 'black' 또는 'white' (이미지 확인 후 조정!)\nNAMES = [\n    'name-1', 'name-2', 'name-3', 'name-4',\n    # ... 좌→우, 위→아래 순서로 아이콘 이름 나열\n]\n# ── 설정 끝 ──────────────────────────────────────\n\nif os.path.exists(OUTPUT):\n    shutil.rmtree(OUTPUT)\nos.makedirs(OUTPUT, exist_ok=True)\n\nimg = Image.open(INPUT)\nw, h = img.size\ncell_w = w \u002F\u002F COLS\ncell_h = h \u002F\u002F ROWS\n\nBG_THRESHOLD = 20 if BG == 'black' else 230\ncount = 0\n\nfor row in range(ROWS):\n    for col in range(COLS):\n        idx = row * COLS + col\n        if idx >= len(NAMES):\n            break\n\n        x1 = col * cell_w\n        y1 = row * cell_h\n        cell = img.crop((x1, y1, x1 + cell_w, y1 + cell_h))\n        if cell.mode != 'RGBA':\n            cell = cell.convert('RGBA')\n\n        # 컨텐츠 영역 감지 (배경이 아닌 픽셀의 바운딩박스)\n        pixels = cell.load()\n        min_x, min_y = cell.size[0], cell.size[1]\n        max_x, max_y = 0, 0\n        for py in range(cell.size[1]):\n            for px in range(cell.size[0]):\n                r, g, b, a = pixels[px, py]\n                if BG == 'black':\n                    is_bg = r \u003C BG_THRESHOLD and g \u003C BG_THRESHOLD and b \u003C BG_THRESHOLD\n                else:\n                    is_bg = r > BG_THRESHOLD and g > BG_THRESHOLD and b > BG_THRESHOLD\n                if not is_bg:\n                    min_x = min(min_x, px)\n                    min_y = min(min_y, py)\n                    max_x = max(max_x, px)\n                    max_y = max(max_y, py)\n\n        if max_x \u003C= min_x or max_y \u003C= min_y:\n            continue\n\n        # 패딩 + 크롭\n        pad = 4\n        min_x = max(0, min_x - pad)\n        min_y = max(0, min_y - pad)\n        max_x = min(cell.size[0], max_x + pad)\n        max_y = min(cell.size[1], max_y + pad)\n        cropped = cell.crop((min_x, min_y, max_x, max_y))\n\n        # 정규화: ICON_SIZE x ICON_SIZE 투명 캔버스\n        inner = ICON_SIZE - 4\n        cw, ch = cropped.size\n        scale = min(inner \u002F cw, inner \u002F ch)\n        new_w = int(cw * scale)\n        new_h = int(ch * scale)\n        cropped = cropped.resize((new_w, new_h), Image.LANCZOS)\n\n        icon = Image.new('RGBA', (ICON_SIZE, ICON_SIZE), (0, 0, 0, 0))\n        icon.paste(cropped, ((ICON_SIZE - new_w) \u002F\u002F 2, (ICON_SIZE - new_h) \u002F\u002F 2))\n\n        # 배경 제거 (슬라이스와 동시 처리)\n        px2 = icon.load()\n        for py in range(ICON_SIZE):\n            for ppx in range(ICON_SIZE):\n                r, g, b, a = px2[ppx, py]\n                if BG == 'black' and r \u003C BG_THRESHOLD and g \u003C BG_THRESHOLD and b \u003C BG_THRESHOLD:\n                    px2[ppx, py] = (0, 0, 0, 0)\n                elif BG == 'white' and r > BG_THRESHOLD and g > BG_THRESHOLD and b > BG_THRESHOLD:\n                    px2[ppx, py] = (0, 0, 0, 0)\n\n        icon.save(os.path.join(OUTPUT, NAMES[idx] + '.png'))\n        count += 1\n\nprint('Sliced', count, 'icons to', OUTPUT)\n\"\n```\n\n### 설정값 가이드\n\n| 항목 | 설명 | 기본값 |\n|------|------|--------|\n| `COLS` | 열 수. **이미지를 직접 보고 세라** | 4 |\n| `ROWS` | 행 수. **이미지를 직접 보고 세라** | 4 |\n| `BG` | 배경색. `'black'` 또는 `'white'`. **이미지를 직접 보고 판단** | `'black'` |\n| `ICON_SIZE` | 출력 아이콘 크기 (px). 게임 UI용 64, 작은 뱃지용 48, 큰 일러스트용 128 | 64 |\n| `NAMES` | 아이콘 파일명 리스트. 좌→우, 위→아래 순서. 영문 kebab-case | - |\n\n### 텍스처 슬라이스 (배경 제거 없이 큰 타일로)\n\n배경 텍스처 등 아이콘이 아닌 타일 리소스는 배경 제거 없이 크게 잘라야 한다:\n\n```python\npython -c \"\nfrom PIL import Image\nimport os\n\nINPUT = '\u003C경로>\u002Ftexture-sprite.png'\nOUTPUT = '\u003C경로>\u002Ficons\u002Ftextures'\nCOLS = 2\nROWS = 2\nNAMES = ['parchment', 'leather', 'stone', 'wood']\n\nos.makedirs(OUTPUT, exist_ok=True)\nimg = Image.open(INPUT)\nw, h = img.size\ncell_w = w \u002F\u002F COLS\ncell_h = h \u002F\u002F ROWS\n\nfor row in range(ROWS):\n    for col in range(COLS):\n        idx = row * COLS + col\n        if idx >= len(NAMES):\n            break\n        cell = img.crop((col * cell_w, row * cell_h, (col+1) * cell_w, (row+1) * cell_h))\n        cell.save(os.path.join(OUTPUT, NAMES[idx] + '.png'))\n\nprint('Sliced', min(len(NAMES), COLS * ROWS), 'textures')\n\"\n```\n\n## 5단계: 결과 검증\n\n생성된 아이콘을 직접 확인한다:\n\n```bash\nls -la \u003COUTPUT 경로>\u002F\n```\n\n빌더 채팅에서 인라인 확인:\n```\n$IMAGE:images\u002Ficons\u002F\u003C카테고리>\u002F\u003C이름>.png$\n```\n\n**잘린 아이콘이 있으면 3단계로 돌아가 그리드 크기를 재확인한다.**\n\n## 주의사항\n\n- **Gemini는 유료 API** — 1장 = 1회 호출. 불필요한 재생성을 피하라\n- **그리드 크기를 추측하지 마라** — 반드시 이미지를 직접 열어 행×열을 세라. Gemini는 요청과 다른 그리드를 생성하는 경우가 많다\n- **배경색을 추측하지 마라** — 검정을 요청해도 흰색으로 나올 수 있다. 이미지를 보고 `BG` 값을 설정하라\n- **최대 요청 그리드** — 4×4 (16개) 권장. Gemini가 더 많이 생성할 수 있지만 그건 보너스\n- **파일명** — 영문 kebab-case (예: `iron-sword.png`, `leather-armor.png`)\n- **console 출력 주의** — Python에서 한글 이모지를 print하면 Windows cp949 인코딩 에러 발생. print에 ASCII만 사용\n\n## 패널에서 아이콘 사용\n\n```html\n\u003Cimg src=\"{{sessionImageBase}}\u002Ficons\u002Fweapons\u002Firon-sword.png\" width=\"32\" height=\"32\">\n```\n\n```html\n\u003Cdiv style=\"background-image: url('{{sessionImageBase}}\u002Ficons\u002Fweapons\u002Firon-sword.png');\n            background-size: contain; width: 32px; height: 32px;\">\u003C\u002Fdiv>\n```\n","# 스프라이트시트 생성 (Gemini + PIL 슬라이스)\n\nGemini 이미지 생성 1회로 N×M 그리드 스프라이트시트를 만들고, Python PIL로 개별 아이콘을 자동 추출한다.\n\n## 파이프라인\n\n```\n1. 프롬프트 설계 (N×M 그리드, 아이콘 목록)\n2. Gemini API 호출 (1장 생성)\n3. 생성 대기 (15-20초)\n4. 생성된 이미지를 직접 확인하여 실제 그리드 크기 파악 (중요!)\n5. Python PIL 슬라이스 (그리드 분할 → 배경 자동 감지 → 크롭 → 정규화 → 배경 제거)\n6. 결과 검증\n```\n\n## 1단계: 프롬프트 설계\n\n### 프롬프트 템플릿\n\n```\nA {cols}x{rows} grid of {카테고리} on a pure black background.\n{총 수} icons arranged in a strictly aligned {cols} columns by {rows} rows grid.\nEach icon must be inside its own clearly separated rectangular cell.\n{스타일 지시}\n\nRow 1 (left to right): {아이템1}, {아이템2}, ...\nRow 2: ...\n...\n\nEach icon should be {품질\u002F스타일 요구사항}.\n```\n\n### 프롬프트 강화 규칙\n\nGemini는 그리드를 자의적으로 해석하는 경향이 있다. 다음 문구를 반드시 포함하여 정규 그리드를 강제한다:\n\n- **그리드 강제**: `\"strictly aligned {cols} columns by {rows} rows grid\"` — \"perfect\" 대신 \"strictly aligned\" 사용\n- **셀 분리 강제**: `\"Each icon must be inside its own clearly separated rectangular cell\"` — 아이콘 간 겹침 방지\n- **배경색 명시**: `\"on a pure black background\"` — 슬라이서가 배경색을 기준으로 동작\n- **정확한 수량 반복**: 프롬프트 첫 줄과 구조 설명 줄에 모두 그리드 크기를 명시\n\n### 주의: Gemini의 그리드 불일치 문제\n\n**Gemini는 요청한 그리드 크기와 다른 결과를 생성할 수 있다.** 예를 들어:\n- 4×4(16개) 요청 → 6×4(24개) 생성\n- 4×3(12개) 요청 → 6×3(18개) 생성\n- 배경색을 검정 대신 흰색으로 생성\n\n**따라서 3단계에서 반드시 이미지를 직접 열어 확인하고, 실제 그리드 크기를 파악한 후 슬라이스해야 한다.**\n\n### 프롬프트 작성 규칙\n\n- 반드시 **영어**로 작성\n- `pure black background` 명시 (배경 제거 기준)\n- 각 Row의 아이콘을 **왼쪽에서 오른쪽 순서로** 구체적으로 나열\n- 스타일 통일 문구 포함: `flat design`, `golden outlines`, `game UI style` 등\n- 최대 권장 요청: **4×4 (16개)** — 실제로 더 많이 생성될 수 있지만 품질 유지됨\n- 텍스트 라벨 방지: `\"no text labels\"` 추가 권장 (Gemini가 아이콘에 이름을 적는 경향 있음)\n\n### 프롬프트 예시\n\n무기 아이콘:\n```\nA 4x4 grid of medieval fantasy RPG weapon icons on a pure black background.\n16 weapon icons arranged in a strictly aligned 4 columns by 4 rows grid.\nEach icon must be inside its own clearly separated rectangular cell.\nFlat design, golden metallic outlines, dark background per icon, game UI style, no text labels.\n\nRow 1 (left to right): iron sword, ornate steel sword, glowing enchanted blade, great sword\nRow 2: dagger, curved assassin blade, hunting bow, longbow\nRow 3: wooden staff, crystal magic staff with purple glow, battle axe, war hammer\nRow 4: spear, halberd, throwing knives, magic wand\n\nEach icon centered in its cell, recognizable silhouette, suitable for inventory UI.\n```\n\n클래스 엠블럼:\n```\nA 4x4 grid of medieval fantasy RPG class emblem icons on a pure black background.\n16 class emblems arranged in a strictly aligned 4 columns by 4 rows grid.\nEach emblem must be inside its own clearly separated rectangular cell.\nRich colors, metallic gold borders, heraldic style, game UI quality, no text labels.\n\nRow 1 (left to right): crossed swords on red shield (Fighter), silver sword and cross on blue (Knight), flaming axe on black (Berserker), bow and arrow on green crest (Ranger)\nRow 2: healing staff on green (Healer), crescent moon and stars on purple (Enchantress), musical note on pink ribbon (Dancer\u002FBard), spear and shield on gray (Soldier)\nRow 3: lance on crimson dragon crest (Dragoon), twin daggers on dark shadow (Thief), holy sun rays on gold (Sage), dark skull on purple flames (Dark Knight)\nRow 4: crown on royal blue (General), treasure chest on amber (Treasure Hunter), shuriken on midnight blue (Ninja), crystal ball on purple (Arcane Mage)\n\nEach emblem should look like a heraldic badge, ornate and detailed.\n```\n\n상태효과:\n```\nA 4x3 grid of RPG status effect icons on a pure black background.\n12 status effect icons in a strictly aligned 4 columns by 3 rows grid.\nEach icon must be inside its own clearly separated rectangular cell.\nClean bold design, glowing effects, game battle UI style, no text labels.\n\nRow 1 (left to right): red upward arrow (ATK buff), blue upward arrow (DEF buff), green healing sparkles (regeneration), golden aura rays (all stats boost)\nRow 2: red downward arrow (ATK debuff), blue downward arrow (DEF debuff), purple skull with drip (poison), orange flame (burn)\nRow 3: ice crystal snowflake (frozen), yellow lightning (stun), pink swirl hearts (charm), green shield bubble (barrier)\n\nEach icon vibrant, immediately recognizable at small sizes.\n```\n\n## 2단계: Gemini 호출\n\n```bash\ncat > \u002Ftmp\u002Fgemini-sprite.json \u003C\u003C 'REQEOF'\n{\n  \"prompt\": \"\u003C설계한 프롬프트>\",\n  \"filename\": \"\u003C카테고리>-sprite.png\",\n  \"persona\": \"\u003C페르소나 이름>\"\n}\nREQEOF\ncurl -s -X POST \"http:\u002F\u002Flocalhost:{{PORT}}\u002Fapi\u002Ftools\u002Fgemini\u002Fgenerate\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d @\u002Ftmp\u002Fgemini-sprite.json\n```\n\n또는 MCP 도구:\n```\nmcp__claude_play__gemini_generate({\n  prompt: \"...\",\n  filename: \"weapons-sprite.png\",\n  persona: \"페르소나이름\"\n})\n```\n\n## 3단계: 생성 확인 + 실제 그리드 파악 (중요!)\n\n```bash\nsleep 15 && ls -la \"\u003C페르소나경로>\u002Fimages\u002F\u003C파일명>\"\n```\n\n**반드시 이미지를 직접 열어서 실제 그리드 크기를 확인한다:**\n\n```\nRead 도구로 이미지를 열어 확인\n```\n\n확인할 사항:\n1. **실제 행×열 수**: 요청한 것과 다를 수 있다 (예: 4×4 요청 → 6×4 생성)\n2. **배경색**: 검정인지 흰색인지 확인 — 슬라이서 모드 결정에 필요\n3. **텍스트 라벨 유무**: 라벨이 포함됐으면 슬라이싱에 영향 줄 수 있음\n4. **아이콘 배치 균일성**: 그리드가 대체로 균일한지\n\n**이 확인 없이 슬라이스하면 아이콘이 잘리거나 병합된다.**\n\n## 4단계: Python PIL 슬라이스 + 배경 제거 (통합)\n\n슬라이스와 배경 제거를 한 번에 처리하는 통합 스크립트. **3단계에서 확인한 실제 그리드 크기와 배경색을 반영하여 설정값을 조정한다.**\n\n```python\npython -c \"\nfrom PIL import Image\nimport os, shutil\n\n# ── 설정 (3단계 확인 결과에 맞게 수정) ───────────\nINPUT = '\u003C페르소나경로>\u002Fimages\u002F\u003C카테고리>-sprite.png'\nOUTPUT = '\u003C페르소나경로>\u002Fimages\u002Ficons\u002F\u003C카테고리>'\nCOLS = 4        # 실제 열 수 (이미지 확인 후 조정!)\nROWS = 4        # 실제 행 수 (이미지 확인 후 조정!)\nICON_SIZE = 64  # 출력 아이콘 크기 (px)\nBG = 'black'    # 배경색: 'black' 또는 'white' (이미지 확인 후 조정!)\nNAMES = [\n    'name-1', 'name-2', 'name-3', 'name-4',\n    # ... 좌→우, 위→아래 순서로 아이콘 이름 나열\n]\n# ── 설정 끝 ──────────────────────────────────────\n\nif os.path.exists(OUTPUT):\n    shutil.rmtree(OUTPUT)\nos.makedirs(OUTPUT, exist_ok=True)\n\nimg = Image.open(INPUT)\nw, h = img.size\ncell_w = w \u002F\u002F COLS\ncell_h = h \u002F\u002F ROWS\n\nBG_THRESHOLD = 20 if BG == 'black' else 230\ncount = 0\n\nfor row in range(ROWS):\n    for col in range(COLS):\n        idx = row * COLS + col\n        if idx >= len(NAMES):\n            break\n\n        x1 = col * cell_w\n        y1 = row * cell_h\n        cell = img.crop((x1, y1, x1 + cell_w, y1 + cell_h))\n        if cell.mode != 'RGBA':\n            cell = cell.convert('RGBA')\n\n        # 컨텐츠 영역 감지 (배경이 아닌 픽셀의 바운딩박스)\n        pixels = cell.load()\n        min_x, min_y = cell.size[0], cell.size[1]\n        max_x, max_y = 0, 0\n        for py in range(cell.size[1]):\n            for px in range(cell.size[0]):\n                r, g, b, a = pixels[px, py]\n                if BG == 'black':\n                    is_bg = r \u003C BG_THRESHOLD and g \u003C BG_THRESHOLD and b \u003C BG_THRESHOLD\n                else:\n                    is_bg = r > BG_THRESHOLD and g > BG_THRESHOLD and b > BG_THRESHOLD\n                if not is_bg:\n                    min_x = min(min_x, px)\n                    min_y = min(min_y, py)\n                    max_x = max(max_x, px)\n                    max_y = max(max_y, py)\n\n        if max_x \u003C= min_x or max_y \u003C= min_y:\n            continue\n\n        # 패딩 + 크롭\n        pad = 4\n        min_x = max(0, min_x - pad)\n        min_y = max(0, min_y - pad)\n        max_x = min(cell.size[0], max_x + pad)\n        max_y = min(cell.size[1], max_y + pad)\n        cropped = cell.crop((min_x, min_y, max_x, max_y))\n\n        # 정규화: ICON_SIZE x ICON_SIZE 투명 캔버스\n        inner = ICON_SIZE - 4\n        cw, ch = cropped.size\n        scale = min(inner \u002F cw, inner \u002F ch)\n        new_w = int(cw * scale)\n        new_h = int(ch * scale)\n        cropped = cropped.resize((new_w, new_h), Image.LANCZOS)\n\n        icon = Image.new('RGBA', (ICON_SIZE, ICON_SIZE), (0, 0, 0, 0))\n        icon.paste(cropped, ((ICON_SIZE - new_w) \u002F\u002F 2, (ICON_SIZE - new_h) \u002F\u002F 2))\n\n        # 배경 제거 (슬라이스와 동시 처리)\n        px2 = icon.load()\n        for py in range(ICON_SIZE):\n            for ppx in range(ICON_SIZE):\n                r, g, b, a = px2[ppx, py]\n                if BG == 'black' and r \u003C BG_THRESHOLD and g \u003C BG_THRESHOLD and b \u003C BG_THRESHOLD:\n                    px2[ppx, py] = (0, 0, 0, 0)\n                elif BG == 'white' and r > BG_THRESHOLD and g > BG_THRESHOLD and b > BG_THRESHOLD:\n                    px2[ppx, py] = (0, 0, 0, 0)\n\n        icon.save(os.path.join(OUTPUT, NAMES[idx] + '.png'))\n        count += 1\n\nprint('Sliced', count, 'icons to', OUTPUT)\n\"\n```\n\n### 설정값 가이드\n\n| 항목 | 설명 | 기본값 |\n|------|------|--------|\n| `COLS` | 열 수. **이미지를 직접 보고 세라** | 4 |\n| `ROWS` | 행 수. **이미지를 직접 보고 세라** | 4 |\n| `BG` | 배경색. `'black'` 또는 `'white'`. **이미지를 직접 보고 판단** | `'black'` |\n| `ICON_SIZE` | 출력 아이콘 크기 (px). 게임 UI용 64, 작은 뱃지용 48, 큰 일러스트용 128 | 64 |\n| `NAMES` | 아이콘 파일명 리스트. 좌→우, 위→아래 순서. 영문 kebab-case | - |\n\n### 텍스처 슬라이스 (배경 제거 없이 큰 타일로)\n\n배경 텍스처 등 아이콘이 아닌 타일 리소스는 배경 제거 없이 크게 잘라야 한다:\n\n```python\npython -c \"\nfrom PIL import Image\nimport os\n\nINPUT = '\u003C경로>\u002Ftexture-sprite.png'\nOUTPUT = '\u003C경로>\u002Ficons\u002Ftextures'\nCOLS = 2\nROWS = 2\nNAMES = ['parchment', 'leather', 'stone', 'wood']\n\nos.makedirs(OUTPUT, exist_ok=True)\nimg = Image.open(INPUT)\nw, h = img.size\ncell_w = w \u002F\u002F COLS\ncell_h = h \u002F\u002F ROWS\n\nfor row in range(ROWS):\n    for col in range(COLS):\n        idx = row * COLS + col\n        if idx >= len(NAMES):\n            break\n        cell = img.crop((col * cell_w, row * cell_h, (col+1) * cell_w, (row+1) * cell_h))\n        cell.save(os.path.join(OUTPUT, NAMES[idx] + '.png'))\n\nprint('Sliced', min(len(NAMES), COLS * ROWS), 'textures')\n\"\n```\n\n## 5단계: 결과 검증\n\n생성된 아이콘을 직접 확인한다:\n\n```bash\nls -la \u003COUTPUT 경로>\u002F\n```\n\n빌더 채팅에서 인라인 확인:\n```\n$IMAGE:images\u002Ficons\u002F\u003C카테고리>\u002F\u003C이름>.png$\n```\n\n**잘린 아이콘이 있으면 3단계로 돌아가 그리드 크기를 재확인한다.**\n\n## 주의사항\n\n- **Gemini는 유료 API** — 1장 = 1회 호출. 불필요한 재생성을 피하라\n- **그리드 크기를 추측하지 마라** — 반드시 이미지를 직접 열어 행×열을 세라. Gemini는 요청과 다른 그리드를 생성하는 경우가 많다\n- **배경색을 추측하지 마라** — 검정을 요청해도 흰색으로 나올 수 있다. 이미지를 보고 `BG` 값을 설정하라\n- **최대 요청 그리드** — 4×4 (16개) 권장. Gemini가 더 많이 생성할 수 있지만 그건 보너스\n- **파일명** — 영문 kebab-case (예: `iron-sword.png`, `leather-armor.png`)\n- **console 출력 주의** — Python에서 한글 이모지를 print하면 Windows cp949 인코딩 에러 발생. print에 ASCII만 사용\n\n## 패널에서 아이콘 사용\n\n```html\n\u003Cimg src=\"{{sessionImageBase}}\u002Ficons\u002Fweapons\u002Firon-sword.png\" width=\"32\" height=\"32\">\n```\n\n```html\n\u003Cdiv style=\"background-image: url('{{sessionImageBase}}\u002Ficons\u002Fweapons\u002Firon-sword.png');\n            background-size: contain; width: 32px; height: 32px;\">\u003C\u002Fdiv>\n```\n",{"name":5,"description":7,"allowed-tools":32},"Bash, Read, Write, Edit","main","87c4e526fb2dfb2c6bfeeb9f901d6320fcb457ec","data\u002Ftools\u002Fgemini\u002Fskills\u002Fgenerate-spritesheet",0,"https:\u002F\u002Fgithub.com\u002FDevelopmentDummy\u002Fclaude-play","https:\u002F\u002Fgithub.com\u002FDevelopmentDummy","2026-10-07 22:33:19",{"source":8,"skillName":5,"commands":41,"prompt":51,"zipAvailable":52},[42,45,48],{"tool":43,"command":44},"npx","npx skills add DevelopmentDummy\u002Fclaude-play --skill generate-spritesheet",{"tool":46,"command":47},"bunx","bunx skills add DevelopmentDummy\u002Fclaude-play --skill generate-spritesheet",{"tool":49,"command":50},"pnpm","pnpm dlx skills add DevelopmentDummy\u002Fclaude-play --skill generate-spritesheet","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FDevelopmentDummy\u002Fclaude-play\u002Fblob\u002Fmain\u002Fdata\u002Ftools\u002Fgemini\u002Fskills\u002Fgenerate-spritesheet\u002FSKILL.md",true,[],[55,79,92,107,116,131],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":69,"publishedAt":27},"01M6PHD8Y8CNRBG3FR2ZAHWX5J","generate-video","claude-play-bridge MCP 서버로 영상을 생성한다. 로컬 ComfyUI의 영상 워크플로 패키지(MiniMax H3 = 영상+오디오 동시 생성, WAN 2.2 i2v, Z-Image→영상)를 호출한다. 렌더가 수 분~수십 분 걸리므로 async 큐잉 + 파일 폴링이 기본 절차다. \"영상\", \"동영상\", \"비디오\", \"video\", \"i2v\", \"t2v\", \"클립 만들어\", \"움직이는\", \"애니메이션 영상\" 요청에 트리거된다.","https:\u002F\u002Fgithub.com\u002FDevelopmentDummy\u002Fclaude-play\u002Fblob\u002Fmain\u002Fscripts\u002Fexternal-package\u002Fskills\u002Fgenerate-video\u002FSKILL.md",[61,66],{"categoryNo":62,"categoryName":63,"taxonomyType":64,"taxonomyTypeDesc":65},"01JBSEEDCAT000000000000016","图像与多媒体","SCENARIO","使用场景",{"categoryNo":67,"categoryName":68,"taxonomyType":64,"taxonomyTypeDesc":65},"01JBSEEDCAT000000000000023","Skill与智能体开发",[70,18,71,72,73,74,75,76,77,78],"generate video","Video","bridge","MCP","image","minimax h3","minimax","async","play",{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":87,"publishedAt":27},"01M6PHD3MAQ9QYQQFG50WBP5JZ","generate-image","claude-play-bridge MCP 서버로 이미지를 생성한다. 기본 백엔드는 ComfyUI(로컬 GPU, 워크플로 패키지 기반)이고, 사용자가 명시적으로 요청할 때만 GPT\u002FGemini 백엔드를 사용한다.","https:\u002F\u002Fgithub.com\u002FDevelopmentDummy\u002Fclaude-play\u002Fblob\u002Fmain\u002Fscripts\u002Fexternal-package\u002Fskills\u002Fgenerate-image\u002FSKILL.md",[85,86],{"categoryNo":62,"categoryName":63,"taxonomyType":64,"taxonomyTypeDesc":65},{"categoryNo":67,"categoryName":68,"taxonomyType":64,"taxonomyTypeDesc":65},[74,18,88,89,72,90,91,78,20,73],"generate image","comfyui","gpt","gpu",{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":99,"publishedAt":27},"01M6PHD0134XK1NQNK4YMZB2E1","generate-image-openai","OpenAI\u002FGPT 이미지 생성(GPT Image 품질 \u002F 텍스트 렌더링·이미지 편집 강점). 기본 백엔드는 Codex CLI 구독(건당 과금 없음). ⚠️ 사용자가 이 백엔드를 명시적으로 지정했을 때만 사용한다(예 \"GPT로\u002FOpenAI로 그려줘\"). 기본 이미지 생성은 generate-image(ComfyUI)이며, 사용자가 콕 집어 요청하지 않았다면 절대 OpenAI를 자동으로 선택하지 마라.","https:\u002F\u002Fgithub.com\u002FDevelopmentDummy\u002Fclaude-play\u002Fblob\u002Fmain\u002Fdata\u002Ftools\u002Fopenai\u002Fskills\u002Fgenerate-image-openai\u002FSKILL.md",[98],{"categoryNo":62,"categoryName":63,"taxonomyType":64,"taxonomyTypeDesc":65},[100,88,101,18,74,26,102,103,104,90,22,23,24,89,105,106],"generate image openai","openai","cli","codex","codex cli","텍스트","렌더링",{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":111,"categories":112,"keywords":114,"publishedAt":27},"01M6PHCPR07KYS2RPNZER9WS2S","generate-image-gemini","Gemini API로 이미지를 생성한다. 패널 배경, UI 리소스, 아이콘, 장면 삽화 등 디자인 리소스 제작에 사용한다. ComfyUI가 없을 때의 이미지 생성 대안이기도 하다.","https:\u002F\u002Fgithub.com\u002FDevelopmentDummy\u002Fclaude-play\u002Fblob\u002Fmain\u002Fdata\u002Ftools\u002Fgemini\u002Fskills\u002Fgenerate-image-gemini\u002FSKILL.md",[113],{"categoryNo":62,"categoryName":63,"taxonomyType":64,"taxonomyTypeDesc":65},[115,88,18,20,74,26,21,22,23,24],"generate image gemini",{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":126,"publishedAt":27},"01M6PHCJD7S7KT64BB9F215TP6","workflow-research","새 ComfyUI 워크플로우를 설계하거나 신규 모델, 양자화 모델, LoRA 개발 전략을 비교할 때 분석 틀을 잡는다.","https:\u002F\u002Fgithub.com\u002FDevelopmentDummy\u002Fclaude-play\u002Fblob\u002Fmain\u002Fdata\u002Ftools\u002Fcomfyui\u002Fskills\u002Fworkflow-research\u002FSKILL.md",[122,125],{"categoryNo":123,"categoryName":124,"taxonomyType":64,"taxonomyTypeDesc":65},"01JBSEEDCAT000000000000021","资料检索与研究",{"categoryNo":67,"categoryName":68,"taxonomyType":64,"taxonomyTypeDesc":65},[127,128,129,130,23,89],"research","workflow","workflow research","LoRA",{"skillNo":132,"name":133,"nameZh":6,"description":134,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":135,"categories":136,"keywords":138,"publishedAt":27},"01M6PHCDNA12EYT4RM3J13PMTK","workflow-package-strategy","이미지 생성용 워크플로우 패키지를 등록, 수정, 조회하거나 params.json과 resolver.mjs의 책임을 나눌 때 사용한다.","https:\u002F\u002Fgithub.com\u002FDevelopmentDummy\u002Fclaude-play\u002Fblob\u002Fmain\u002Fdata\u002Ftools\u002Fcomfyui\u002Fskills\u002Fworkflow-package-strategy\u002FSKILL.md",[137],{"categoryNo":67,"categoryName":68,"taxonomyType":64,"taxonomyTypeDesc":65},[139,128,140,141,23,26,142],"package","strategy","workflow package strategy","resolver"]