Activos de imagen finales
<skill-dir> es la carpeta que contiene este SKILL.md, y <plugin-root> está dos carpetas por encima. Reemplázalos con rutas reales en los comandos. (En Claude Code son ${CLAUDE_SKILL_DIR} y ${CLAUDE_PLUGIN_ROOT}).
Entrada: un activo o una lista, como "icono de racha congelada" o "los 6 iconos de recompensa en el GDD de misiones diarias". Salida: PNGs en la ruta de activos del juego, cada uno registrado con su prompt y modelo.
Primero lee <plugin-root>/shared/conventions.md y la configuración del repositorio (sección Arte).
GI="<skill-dir>/scripts/gen_image.py" # Solo Python 3; nunca imprime la clave
python3 "$GI" check # clave + modelo que se usaría, sin costo (ejecutar desde el repositorio del juego)
python3 "$GI" generate --prompt "…" --out <file.png> [--size WxH] [--background transparent] [--ref <art.png> …] [--log <log.jsonl>]
0. ¿Está activada la generación de imágenes para este proyecto?
Lee config: Generación de imágenes:
on: ve al paso 1.off: no generes. Usa arte existente o el patrón de marcador de posición del repositorio, y lista los activos aún necesarios (nombre, tamaño, uso) en el informe. No preguntes de nuevo.not seto falta: esta es la primera imagen para este proyecto. Ejecutacheck, luego pregunta con la herramienta de preguntas:- Si no se encontró clave, la pregunta dice que los activos finales usan por defecto GPT Image de OpenAI (la versión más nueva, 2 o posterior) y que se necesita una clave API. Las opciones son:
- Configurar una clave ahora (Recomendado): muestra los pasos de configuración a continuación y espera hasta que el usuario diga que está listo. Luego ejecuta
checkde nuevo. Cuando esté listo, escribeon. - No para este proyecto: escribe
off (optó no participar <YYYY-MM-DD>)y continúa sin arte generado. - Ahora no: omite imágenes esta vez, deja el campo
not sety pregunta de nuevo la próxima vez.
- Configurar una clave ahora (Recomendado): muestra los pasos de configuración a continuación y espera hasta que el usuario diga que está listo. Luego ejecuta
- Si se encontró una clave (en el
.envdel repositorio, en el entorno o configurada para otro proyecto), la pregunta indica dónde se encontró y el modelo quecheckeligió. Sicheckdice que el archivo.envestá bajo control de git, advierte que la clave está comprometida y debe rotarse, y recomienda moverla fuera de git. Las opciones son: usarla para este proyecto (Recomendado, luego escribeon), no para este proyecto (off) y ahora no.
- Si no se encontró clave, la pregunta dice que los activos finales usan por defecto GPT Image de OpenAI (la versión más nueva, 2 o posterior) y que se necesita una clave API. Las opciones son:
Configuración de clave API (muestra esto al usuario)
- Ve a platform.openai.com → API keys → Create new secret key. Lo mejor es una clave con ámbito de proyecto.
- Asegúrate de que Billing tenga crédito. Los modelos GPT Image también pueden pedirte que verifiques tu organización (Settings → Organization → General). El acceso puede tardar unos minutos en activarse después de la verificación.
- Guarda la clave en esta máquina. Nunca la pegues en el chat.
- macOS (recomendado): ejecuta esto en Terminal. Pide la clave sin mostrarla y la almacena en el Llavero:
security add-generic-password -U -a "$USER" -s gd-toolkit-openai -w - Solo este proyecto: añade
OPENAI_API_KEY=…al.envo.env.localdel repositorio. Verifica primero que el archivo esté en.gitignore. - En cualquier lugar: añade
export OPENAI_API_KEY=…a tu perfil de shell, como~/.zshrc, luego abre una nueva terminal. - O usa un archivo legible solo por ti:
~/.config/gd-toolkit/openai_api_key(chmod 600).
- macOS (recomendado): ejecuta esto en Terminal. Pide la clave sin mostrarla y la almacena en el Llavero:
- Dime cuando esté listo y lo comprobaré. Esa comprobación no tiene costo.
Una clave en el Llavero, el shell o el archivo de configuración funciona para todos los proyectos; una clave .env funciona para su repositorio y prevalece sobre el Llavero. La elección de activado/desactivado se hace por proyecto.
1. Planificar los activos
- Estilo: lee config: Estilo de arte y observa el arte de referencia que lista. Pasa 1–4 de los activos existentes más cercanos como
--ref, para que el nuevo arte coincida con el juego. Describe el estilo en cada prompt con las mismas palabras: paleta, grosor de línea, sombreado, ángulo de cámara y material. - Especificaciones: para cada activo, su tamaño final, su formato, si necesita transparencia, su nombre de archivo y su ruta (config: Directorio de activos, más el patrón de nombres del repositorio).
- Muestra la lista, con su conteo total y modelo, y genera una vez que el usuario la apruebe. Una sola confirmación cubre todo el lote.
2. Generar
- Modelo:
--model auto(el predeterminado) usa el modelo gpt-image más nuevo, versión 2 o posterior, que la clave pueda usar, prefiriendo la variante detallada para arte final.--fast(pasado como--prefer fast) es solo para borradores. Si config: Modelo de imagen nombra un modelo, pásalo con--model. - Tamaño: genera en el cuadrado más grande del modelo o en la relación de aspecto más cercana, luego reduce al tamaño final (
sips -Z <px>en macOS). Nunca amplíes. - Transparencia: iconos, objetos y sprites necesitan
--background transparent. Si la salida indica que el modelo lo rechazó, la imagen se volvió opaca: regenera con un color de fondo plano y sólido nombrado en el prompt, elimina ese color y menciónalo en el informe. - Prompt: describe el sujeto, luego el bloque de estilo, luego la composición (centrado, relleno, sin texto a menos que se solicite). Pide que no haya palabras, logotipos ni marcas de agua a menos que el activo necesite texto.
- Registra cada generación en config: Registro de arte (
--log). Nunca coloques archivos de metadatos junto a los activos distribuidos.
3. Revisar cada imagen
Mira cada imagen antes de conservarla, usando una copia pequeña para ahorrar contexto. Regénerala, como máximo 3 veces, si no coincide con las referencias de estilo, tiene texto suelto o artefactos, está recortada incorrectamente o es ilegible en su tamaño más pequeño dentro del juego. Si sigue fallando, conserva la mejor y márcala.
4. Informe
Lista cada activo con su ruta, tamaños, modelo y cualquier marca. También da los activos aún necesarios (si la generación está off o se omitió), y la ruta del registro. Di que las imágenes son generadas por IA, para que el propietario pueda decidir dónde debe revelarse, como en las listas de la tienda.