muend/codex-image

Generación de imágenes a través de Codex

Claude escribe la dirección de arte; gpt-6.1-sol la ejecuta literalmente con su herramienta de imágenes incorporada. El brief es el techo de calidad absoluto: Sol no inventará bien los detalles faltantes y no "usará el juicio" en preguntas abiertas. Decide todo primero, luego escríbelo.

Motor y perfiles de rol

Las imágenes provienen de la herramienta image_gen incorporada de Codex en el inicio de sesión de ChatGPT Pro (sin API, sin cargos por imagen). Esa herramienta solo acepta un prompt, imágenes de referencia y transparent_background; el servidor elige el modelo de imagen, por lo que no se pueden seleccionar modelos específicos (GPT Image 2.6 Sunburst / Flare, etc.). Nunca cambies a una clave API o al fallback de la CLI de imágenes de Codex.

El control específico del rol proviene de los perfiles en ~/.claude/skills/codex/image-profiles.json, pasados con -ImageProfile <nombre>. Un perfil agrega notas de estilo de rol al brief y puede forzar la transparencia:

Perfil	Uso	Notas
default	cualquier otra cosa	solo el brief
photoreal	tomas de producto, banners principales, fotos editoriales	reglas de realismo fotográfico
illustration	arte de marketing/blog/onboarding	reglas de ilustración cohesivas
icon	iconos de app/UI, marcas, stickers, sprites	transparente, relleno, legibilidad a 32px
ui-asset	maquetas, visuales de dashboard, estados vacíos	geometría nítida, sin micro-texto falso
text-heavy	carteles, portadas, infografías	tipografía exacta primero

-Transparent funciona con cualquier perfil. Agrega nuevos roles añadiendo una entrada (transparent, roles, style_notes) al JSON. El brief sigue siendo la palanca de calidad principal: los perfiles añaden, nunca reemplazan.

Flujo de trabajo

1. Aclara solo lo que realmente te bloquea (propósito, dónde se usará, tamaño/proporción, texto en la imagen, colores de marca). De lo contrario, elige valores predeterminados sensatos y establécelos en el brief.
2. Escribe el brief en un archivo en el bloc de notas (ej. brief-hero.md) usando la plantilla a continuación. Completa cada sección; escribe "ninguno" en lugar de omitir una sección.
3. Ejecuta:

   pwsh -NoProfile -File "$HOME\.claude\skills\codex\scripts\codex.ps1" -Mode image `
     -PromptFile <brief.md> -Out <proyecto>\assets\<nombre>.png [-ImageProfile icon] [-Transparent] `
     [-Count 3] [-Images ref1.png,ref2.png]
   

   Usa timeout: 600000. Varias imágenes diferentes → una ejecución en segundo plano por imagen (una flota).
4. Verifícalo tú mismo: Lee cada archivo CODEX_IMAGE= y compáralo con la lista de verificación de aceptación. La autocomprobación de Codex es una afirmación, no una prueba.
5. Itera con -Session <CODEX_THREAD_ID> y un breve delta breve ("Mantén todo; cambia solo: ..."), o haz una edición dirigida pasando la salida anterior con -Images y un breve de edición.
6. Entrega: muestra la imagen al usuario (Léela / SendUserFile), proporciona la ruta y menciona que el ID del hilo está disponible para más iteraciones.

Plantilla de brief (copia, completa cada campo)

# Propósito y uso
<para qué sirve esta imagen, dónde aparece (banner principal, icono de app, diapositiva, impresión), audiencia>

# Salida
- Relación de aspecto / tamaño: <ej. 16:9 apaisado, 1:1 cuadrado, 9:16 vertical; px objetivo si se conoce>
- Formato/fondo: <opaco | fondo transparente | sólido #FFFFFF>
- Variantes: <1 | N, y cómo deben diferir las variantes>

# Sujeto
<sujeto(s) principal(es) en términos concretos: quién/qué, cantidad, pose, expresión, acción, vestimenta/material,
edad/etnicidad solo si es relevante y lo especifica el usuario>

# Composición y cámara
- Encudre: <primer plano | medio | gran angular | vista cenital | isométrica | ortográfica plana>
- Colocación: <posición del sujeto (regla de los tercios, centrado), espacio negativo para texto en qué lado>
- Cámara/lente (estilos fotográficos): <ej. 50 mm, f/2.8 profundidad de campo reducida, a nivel del ojo>
- Primer plano / plano medio / fondo: <cada uno descrito>

# Estilo
- Medio: <fotorrealista | render 3D | vectorial plano | arte lineal | acuarela | pixel art | arcilla | isométrico ...>
- Referencias en palabras: <época, movimiento, textura, grosor de línea, nivel de detalle> (sin nombres de artistas vivos)
- Detalle de renderizado: <formas mínimas | moderado | muy detallado>

# Color y luz
- Paleta: <códigos hex con funciones, ej. primario #1E6FFF, acento #FFC233, fondo #F5F5F7>
- Iluminación: <luz suave diurna desde la izquierda | iluminación de estudio de tres puntos | hora dorada | luz de neón de borde>
- Ambiente: <tranquilo, enérgico, premium, divertido ...>

# Texto en la imagen
<"ninguno" O cada cadena textual entre comillas, con sensación tipográfica (sans-serif geométrica negrita), color, posición, tamaño
relativo a la imagen. Mantén las cadenas cortas; la ortografía y las mayúsculas exactas importan.>

# Debe incluir
- <elementos no negociables>

# NO debe incluir
- <marcas de agua, texto extra, dedos extra, logotipos de marcas reales, desorden, colores específicos ...>

# Instrucciones de edición (solo al editar una imagen adjunta)
- La imagen 1 es: <la imagen a editar | una referencia de estilo | una referencia de sujeto>
- Cambio: <exactamente qué>
- Conserva: <todo lo demás que debe permanecer idéntico: diseño, rostros, colores, texto>

# Lista de verificación de aceptación
- [ ] <comprobaciones objetivas que Claude verificará: relación de aspecto, sujeto presente, texto exacto, paleta, sin X>

Notas de redacción para resultados sólidos

• Los sustantivos concretos y los atributos medibles superan a los adjetivos ("tres tazas de cerámica, verde salvia mate #9CAF88, sobre una mesa de nogal" ≫ "tazas bonitas y acogedoras").
• Un punto focal claro; indica dónde irá el espacio vacío si se superpondrá texto después.
• Para iconos/logotipos: planos, pocos colores, centrados, relleno generoso, sin texto a menos que se solicite, probar en tamaño pequeño.
• Para activos de UI/marketing: especifica el texto exacto y mantén el texto en la imagen al mínimo: el texto real de la interfaz se agrega mejor en código.
• Para series/conjuntos (sprites, paquetes de iconos, storyboards): escribe una sección compartida de "biblia de estilo" y reutilízala textualmente en el brief de cada viñeta para que el conjunto sea coherente; genera primero un héroe, apruébalo, luego pásalo con -Images como referencia de estilo para el resto.
• No solicites la apariencia de personas reales, personajes protegidos por derechos de autor o logotipos de marcas reales.