CommunityImagengithub.com

asset

Genera activos finales de imágenes del juego (iconos, objetos, fondos, personajes, arte de tienda) con el modelo de imagen GPT más nuevo de OpenAI, versión 2 o posterior, combinados con el arte existente del juego.

¿Qué es asset?

El skill 'asset' permite generar activos de imagen finales para un juego, como iconos, objetos, fondos, personajes y arte de tienda, utilizando el modelo de imagen GPT más reciente de OpenAI (versión 2 o posterior). Está diseñado para integrarse con el flujo de trabajo de desarrollo de juegos, asegurando que el arte generado coincida con el estilo existente del juego mediante referencias visuales. Soporta plataformas como Claude Code, Cursor y Codex, y se activa con comandos como `/gd:asset` o cuando se solicita arte final. El skill maneja la configuración inicial de la clave API de OpenAI, permite optar por no usar generación de imágenes por proyecto, planifica los activos según el estilo y especificaciones, genera las imágenes, las revisa con hasta 3 reintentos, y reporta los resultados. Es útil para desarrolladores que necesitan activos visuales pulidos sin depender de diseñadores externos, manteniendo consistencia artística y control de calidad.

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

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 set o falta: esta es la primera imagen para este proyecto. Ejecuta check, 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:
      1. 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 check de nuevo. Cuando esté listo, escribe on.
      2. No para este proyecto: escribe off (optó no participar <YYYY-MM-DD>) y continúa sin arte generado.
      3. Ahora no: omite imágenes esta vez, deja el campo not set y pregunta de nuevo la próxima vez.
    • Si se encontró una clave (en el .env del repositorio, en el entorno o configurada para otro proyecto), la pregunta indica dónde se encontró y el modelo que check eligió. Si check dice que el archivo .env está 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 escribe on), no para este proyecto (off) y ahora no.

Configuración de clave API (muestra esto al usuario)

  1. Ve a platform.openai.com → API keys → Create new secret key. Lo mejor es una clave con ámbito de proyecto.
  2. 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.
  3. 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 .env o .env.local del 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).
  4. 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.

Individual skills in this repo

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

Skills relacionados