From minigame-assets
Use this skill whenever the user asks to generate game assets — sprites, characters, weapons, backgrounds, UI, logos, thumbnails, music, or any art/sound for a game — via the minigame-assets MCP (tools prefixed with `asset_`). Enforces the CONCEPT-first workflow so CONCEPT.md is created from planning docs before any generation tool fires. Triggers on phrases like "게임 에셋 만들어줘", "스프라이트 생성", "create game assets", "generate sprites", "make a character for my game".
How this skill is triggered — by the user, by Claude, or both
Slash command
/minigame-assets:minigame-assets-workflowThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
게임 에셋 생성은 **항상 컨셉부터** 시작합니다. `asset_*` 도구를 호출하기 전에 아래 체크를 수행하세요.
게임 에셋 생성은 항상 컨셉부터 시작합니다. asset_* 도구를 호출하기 전에 아래 체크를 수행하세요.
생성 요청을 받으면, 어떤 도구를 호출하기 전에 다음 순서로 반드시 컨셉을 찾아보세요.
CONCEPT.md 또는 game-concept.json 존재 여부 확인 (Read/Glob)asset_get_concept 도구로 저장된 컨셉 조회README.md, GDD.md, GAME_DESIGN.md, game-design.md, design-doc.md, master-plan.md, docs/*.md, _bmad-output/**/*.md 등package.json / 소스 코드에서 엔진 힌트 (Phaser, Unity, Cocos, Godot) 수집컨셉이 이미 있으면: 추가 질문 없이 바로 Step 0.5로 진행. 사용자가 CONCEPT.md 를 이미 작성해 뒀다면 그걸 신뢰하세요.
없으면: asset_create_concept_md 를 호출해 CONCEPT.md + game-concept.json 을 생성. 기획 문서에서 최대한 정보를 추출한 뒤 부족한 필드만 짧게 질문하세요. 절대 asset_create_concept (JSON-only 레거시) 는 쓰지 말 것 — _md 버전이 표준이며 base_style_prompt, characters[], weapons[], backgrounds[] 까지 구조화된 필드를 담습니다.
게임 프로젝트에 이미 코드가 있으면 생성 전에 asset_scan_display_sizes 를 호출해 실제 런타임 표시 크기를 파악하세요. 예:
asset_scan_display_sizes
project_path: "."
감지 예시:
add.sprite(x, y, 'hero').setDisplaySize(64, 64) → hero 64×64 으로 표시됨 → 생성 크기 128×128 권장 (2× 헤드룸).setScale(0.5) → 1024 소스가 512 로 축소 표시됨 → 1024 생성 적합setContentSize, Godot Vector2(scale) 도 지원결과의 suggested_generation_size 를 각 asset_generate_* 호출의 size 파라미터로 전달:
asset_generate_character_base
character_name: "hero"
size: "128x128" ← 스캔 결과 사용
...
코드가 없는 새 프로젝트이거나 크기 힌트가 없는 경우는 이 단계를 건너뛰고 기본값(1024×1024)으로 생성.
| # | 도구 | 기본 AI | 메모 |
|---|---|---|---|
| 1 | asset_create_concept_md | — | CONCEPT.md + game-concept.json |
| 2 | asset_generate_execution_plan | — | 엔진 감지 + 체크리스트 |
| 3 | asset_generate_character_base | gpt-image-2 | 마젠타 크로마키 → 투명, role 파라미터 활용 |
| 3.5 | asset_generate_character_equipped | gpt-image-2 edit | 장비 착용 베이스 합성 (선택) |
| 4 | asset_generate_weapons | gpt-image-1 | 네이티브 투명 배경 |
| 5 | asset_generate_sprite_sheet | gpt-image-2 edit | 1행 가로 스트립 기본, chroma_key_bg: "magenta" |
| 6 | asset_generate_screen_background / _loading_screen / _lobby_screen | gpt-image-2 | parallax 레이어는 Gemini |
| 7 | asset_generate_app_logo, asset_plan_thumbnail → asset_generate_thumbnail | — | 마케팅 |
| 8 | asset_review, asset_validate, asset_list_missing, asset_generate_atlas_json | — | 품질 검토 + Atlas |
사용자가 전체 워크플로를 돌리고 싶다고 하면 아래 중 하나를 권장:
/create-minigame-assets — 새 프로젝트용 (컨셉 생성부터 전체)/setup-minigame-assets-concept — 기존 게임 프로젝트 분석 + 누락 에셋 생성/minigame-assets-help — 현재 상태 대시보드base_style_prompt 는 모든 이미지 생성의 접두사 — 스타일·색상·질감을 영문으로 구체적으로 작성refine_prompt: true 로 GPT-5.4-nano 확장 활성화OPENAI_API_KEY (필수) / GEMINI_API_KEY (parallax·video 시 필요) 환경변수가 있어야 함CONCEPT_FILE (기본 ./game-concept.json), CONCEPT_MD_FILE (기본 ./CONCEPT.md) 환경변수로 오버라이드 가능이 워크플로 중 특정 주제가 나오면 해당 스킬이 자동으로 함께 트리거됩니다:
| 질문/상황 | 트리거되는 스킬 |
|---|---|
| "어디까지 했지?", "지금 뭐 해야 해" | minigame-assets-status (현재 상태 대시보드) |
| "용량 줄이고 싶어", "WebP 쓸까?", "너무 커" | minigame-assets-optimize |
| "품질 확인", "검증", "마젠타 잔류" | minigame-assets-review |
| "스타일 일관성", "같은 캐릭터 유지" | minigame-assets-style-consistency |
| "Phaser 로딩 코드", "Unity import" | minigame-assets-engine-load |
| "비용 얼마야", "어떤 모델이 싸?" | minigame-assets-cost |
Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub limsuyun/minigame-assets-mcp --plugin minigame-assets