Community이미지github.com

에셋

OpenAI의 최신 GPT 이미지 모델(v2 이상)을 사용하여 게임의 기존 아트 스타일에 맞춰 최종 게임 이미지 에셋(아이콘, 아이템, 배경, 캐릭터, 스토어 아트)을 생성합니다.

에셋란 무엇인가요?

이 스킬은 게임 개발자가 최종 게임 이미지 에셋(아이콘, 아이템, 배경, 캐릭터, 스토어 아트 등)을 생성할 수 있도록 도와줍니다. OpenAI의 최신 GPT 이미지 모델(v2 이상)을 사용하여 생성된 에셋이 기존 게임 아트 스타일과 일치하도록 보장합니다. 프로젝트에서 처음 사용할 때 OpenAI API 키 설정 방법을 안내하고, 사용자가 프로젝트 자체를 이미지 생성에서 제외할 수 있도록 합니다. 사용자가 `/gd:asset` 명령을 실행하거나 최종 아트, 아이콘, 스프라이트를 요청하거나 다른 gd 명령이 최종 이미지 에셋을 필요로 할 때 사용됩니다. GDD 목업(HTML 및 CSS로 유지)에는 사용되지 않습니다. 이 스킬은 Claude Code 환경에서 작동하며, 에셋 계획, 스타일 일치, 생성, 확인 및 보고를 위한 명령어와 지침을 제공합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/robson-work/gd-toolkit/tree/HEAD/skills/asset

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

최종 이미지 에셋

<skill-dir>는 이 SKILL.md가 있는 폴더이고, <plugin-root>는 그 위 두 폴더입니다. 명령어에서 실제 경로로 바꿔 사용하세요. (Claude Code에서는 ${CLAUDE_SKILL_DIR} 및 ${CLAUDE_PLUGIN_ROOT}입니다.)

입력: 하나의 에셋 또는 목록(예: "streak freeze icon" 또는 "daily-quests GDD의 6개 보상 아이콘"). 출력: 게임의 에셋 경로에 PNG 파일로 저장되며, 각 에셋은 프롬프트와 모델과 함께 기록됩니다.

먼저 <plugin-root>/shared/conventions.md와 저장소 설정(Art 섹션)을 읽으세요.

GI="<skill-dir>/scripts/gen_image.py"   # Python 3 전용; 키를 절대 출력하지 않음
python3 "$GI" check                              # 사용될 키와 모델 표시, 비용 없음 (게임 저장소에서 실행)
python3 "$GI" generate --prompt "…" --out <file.png> [--size WxH] [--background transparent] [--ref <art.png> …] [--log <log.jsonl>]

0. 이 프로젝트에서 이미지 생성이 켜져 있습니까?

config: Image generation을 읽으세요:

  • on: 1단계로 이동합니다.
  • off: 생성하지 않습니다. 기존 아트나 저장소의 플레이스홀더 패턴을 사용하고, 보고서에 여전히 필요한 에셋(이름, 크기, 용도)을 나열합니다. 다시 묻지 않습니다.
  • not set 또는 누락: 이 프로젝트의 첫 번째 이미지입니다. check를 실행한 다음, 질문 도구로 물어보세요:
    • 키를 찾을 수 없는 경우, 질문은 최종 에셋이 기본적으로 OpenAI의 GPT Image(최신 버전, v2 이상)를 사용하며 API 키가 필요하다고 설명합니다. 옵션은 다음과 같습니다:
      1. 지금 키 설정 (권장): 아래 설정 단계를 보여주고 사용자가 완료했다고 말할 때까지 기다립니다. 그런 다음 check를 다시 실행합니다. 준비되면 on을 작성합니다.
      2. 이 프로젝트에는 사용 안 함: off (opted out <YYYY-MM-DD>)를 작성하고 생성된 아트 없이 계속 진행합니다.
      3. 지금은 안 함: 이번에는 이미지를 건너뛰고, 필드를 not set으로 남겨두고 다음 번에 다시 묻습니다.
    • 키를 찾은 경우(저장소의 .env, 환경, 또는 다른 프로젝트용으로 설정된 경우), 질문은 키가 발견된 위치와 check가 선택한 모델을 알려줍니다. check가 .env 파일이 git에 추적되고 있다고 말하면, 키가 커밋되었으며 교체해야 하고 git 밖으로 이동할 것을 권장한다고 경고합니다. 옵션은 다음과 같습니다: 이 프로젝트에 사용 (권장, 그런 다음 on 작성), 이 프로젝트에는 사용 안 함 (off), 지금은 안 함.

API 키 설정 (사용자에게 표시)

  1. platform.openai.com → API keys → Create new secret key로 이동합니다. 프로젝트 범위 키가 가장 좋습니다.
  2. Billing에 크레딧이 있는지 확인합니다. GPT Image 모델은 조직 인증(Settings → Organization → General)을 요청할 수도 있습니다. 인증 후 액세스가 활성화되는 데 몇 분 정도 걸릴 수 있습니다.
  3. 이 머신에 키를 저장합니다. 절대 채팅에 붙여넣지 마세요.
    • macOS (권장): 터미널에서 다음을 실행합니다. 키를 표시하지 않고 요청하며 Keychain에 저장합니다: security add-generic-password -U -a "$USER" -s gd-toolkit-openai -w
    • 이 프로젝트만: OPENAI_API_KEY=…를 저장소의 .env 또는 .env.local에 추가합니다. 파일이 .gitignore에 있는지 먼저 확인하세요.
    • 어디서나: export OPENAI_API_KEY=…를 셸 프로필(예: ~/.zshrc)에 추가한 다음 새 터미널을 엽니다.
    • 또는 사용자만 읽을 수 있는 파일 사용: ~/.config/gd-toolkit/openai_api_key (chmod 600).
  4. 완료되면 알려주세요. 확인하겠습니다. 이 확인은 비용이 들지 않습니다.

Keychain, 셸 또는 설정 파일에 있는 키는 모든 프로젝트에서 작동합니다. .env 키는 해당 저장소에서 작동하며 Keychain보다 우선합니다. 켜기/끄기 선택은 프로젝트별로 이루어집니다.

1. 에셋 계획

  • 스타일: config: Art style과 그에 나열된 참조 아트를 읽으세요. 가장 가까운 기존 에셋 1~4개를 --ref로 전달하여 새 아트가 게임과 일치하도록 합니다. 모든 프롬프트에서 동일한 단어로 스타일을 설명하세요: 팔레트, 선 두께, 음영, 카메라 각도 및 재질.
  • 사양: 각 에셋에 대해 최종 크기, 형식, 투명도 필요 여부, 파일 이름 및 경로(config: Assets dir, 저장소의 명명 패턴 기준)입니다.
  • 목록을 총 개수와 모델과 함께 표시하고, 사용자가 승인하면 생성합니다. 한 번 확인으로 배치 전체를 처리합니다.

2. 생성

  • 모델: --model auto(기본값)는 키가 사용할 수 있는 최신 gpt-image 모델(v2 이상)을 사용하며, 최종 아트의 경우 상세 변형을 선호합니다. --fast(--prefer fast로 전달)는 드래프트 전용입니다. config: Image model이 모델을 지정하면 --model과 함께 전달합니다.
  • 크기: 모델의 가장 큰 정사각형 또는 가장 가까운 종횡비로 생성한 다음 최종 크기로 축소합니다(macOS에서는 sips -Z <px>). 절대 확대하지 마십시오.
  • 투명도: 아이콘, 아이템 및 스프라이트는 --background transparent가 필요합니다. 출력에서 모델이 거부했다고 표시되면 이미지가 불투명하게 생성된 것입니다: 프롬프트에 명명된 평평하고 단순한 배경색으로 다시 생성하고, 그 색상을 제거하고 보고서에 그 내용을 명시합니다.
  • 프롬프트: 주제를 설명한 다음 스타일 블록, 그 다음 구성(중앙 정렬, 여백, 요청하지 않은 경우 텍스트 없음)을 설명합니다. 에셋에 텍스트가 필요한 경우가 아니면 단어, 로고 또는 워터마크를 요청하지 마십시오.
  • 모든 생성을 config: Art log에 기록합니다(--log). 출시되는 에셋 옆에 메타데이터 파일을 절대 두지 마십시오.

3. 각 이미지 확인

컨텍스트를 절약하기 위해 작은 복사본을 사용하여 각 이미지를 보관하기 전에 확인합니다. 스타일 참조와 일치하지 않거나, 잘못된 텍스트나 아티팩트가 있거나, 잘못 잘렸거나, 게임 내 최소 크기에서 읽을 수 없는 경우 최대 3번까지 다시 생성합니다. 그래도 실패하면 가장 좋은 것을 유지하고 플래그를 지정합니다.

4. 보고서

각 에셋을 경로, 크기, 모델 및 모든 플래그와 함께 나열합니다. 또한 여전히 필요한 에셋(생성이 off이거나 건너뛴 경우)과 로그 경로를 제공합니다. 이미지가 AI 생성이므로 소유자가 스토어 목록 등에서 공개가 필요한지 결정할 수 있다고 말합니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬