CommunityImagengithub.com

openai-img-gen

Genera o edita imágenes con los modelos de imagen de OpenAI. Úsalo cuando el usuario pida crear, generar, dibujar o renderizar una imagen, ilustración, maqueta, arte conceptual, idea de logotipo o fotografía, o editar, recolorizar, cambiar de estilo o combinar fotos o imágenes existentes, incluso si no menciona OpenAI.

¿Qué es openai-img-gen?

Esta habilidad (skill) te permite generar y editar imágenes mediante la API de OpenAI Images utilizando Node.js (versión 18.3+). Es ideal para crear ilustraciones, maquetas, conceptos artísticos, logotipos, fotos y más, así como para modificar o combinar imágenes existentes. Es compatible con el asistente AI (como Claude Code, Cursor, Codex) y se ejecuta como un script de línea de comandos. El usuario debe configurar la clave de API en una variable de entorno (`OPENAI_API_KEY`). La herramienta guarda las imágenes en una carpeta configurable (por defecto mediante `$OPENAI_IMG_GEN_OUT`) o en una ruta especificada con `-o DIR`. Ofrece opciones para controlar el tamaño, la calidad, el formato (PNG, JPEG, WebP), el fondo transparente y el número de imágenes generadas. Además, registra el progreso, el uso de tokens, el costo y los errores en stderr, y guarda el prompt junto a cada imagen. El flujo de trabajo recomendado incluye: escribir un prompt detallado (si es largo, en un archivo), ejecutar el comando con `-p` para el proyecto, mostrar el resultado al usuario (leyendo la imagen), e iterar sobre el prompt hasta obtener el resultado deseado. Si la solicitud es bloqueada por moderación, se sugiere reformular el prompt. La habilidad también proporciona pautas para escribir buenos prompts: especificar claramente el propósito de cada imagen de entrada, dar una tarea única, listar lo que debe permanecer igual, citar texto exacto, nombrar el estilo y finalizar con una línea “Evitar:” para evitar fallos comunes.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/kingfishx23/openai-img-gen/tree/HEAD/skills/openai-img-gen

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

¿Qué hace openai-img-gen?

index.js en el directorio de esta habilidad llama a la API de OpenAI Images. No tiene dependencias y necesita Node 18.3+.

node <directorio de esta habilidad>/index.js [opciones] "prompt"
node <directorio de esta habilidad>/index.js -i foto.jpg -i referencia.png [opciones] -f prompt.txt

Sin -i crea una nueva imagen. Con -i edita o combina las imágenes dadas. Imprime la ruta absoluta de cada archivo guardado en stdout y guarda el prompt junto a las imágenes como <nombre>-<hora>.prompt.txt. El progreso, el uso de tokens, el costo y los errores van a stderr. Ejecuta --help para ver todas las opciones. Las principales son -p NOMBRE (subcarpeta del proyecto), -o DIR (carpeta exacta), --name PREFIJO, -s auto|1024x1024|1536x1024|1024x1536, -q auto|baja|media|alta, -n CONTEO, --format png|jpeg|webp y --background transparente.

Dónde van las imágenes: con -p NOMBRE van a $OPENAI_IMG_GEN_OUT/NOMBRE/. La carpeta base se establece en el .env de esta habilidad, o si no, es la carpeta actual. -o DIR anula eso y guarda exactamente allí.

Pasos

  1. Escribe el prompt. Para algo más largo que una oración, escríbelo en un archivo y pásalo con -f. Consulta "Cómo escribir prompts" más abajo.
  2. Ejecútalo. Siempre pasa -p con un nombre corto para el proyecto en contexto: la marca, producto, repositorio o carpeta en la que está trabajando el usuario (por ejemplo -p es-sebelas o -p kualing), o un tema corto si no hay proyecto. Pasa -o solo cuando el usuario nombre una carpeta. Usa un --name descriptivo. Cada llamada cuesta dinero. Una imagen con -q auto suele costar unos pocos centavos, y alta y -n multiplican eso. Usa -q baja para borradores rápidos, y pregunta antes de hacer más de aproximadamente 4 imágenes o muchas de alta calidad.
  3. Muestra el resultado. Abre el archivo guardado con la herramienta de lectura para que puedas verlo. Compruébalo contra el prompt (ortografía del texto, lo que debía permanecer igual), luego dile al usuario la ruta, lo que ves y la línea de costo.
  4. Itera. Cambia el prompt según lo que haya fallado y mantén el archivo de prompt actualizado para que coincida con el mejor resultado.

Si no hay clave de API, dile al usuario que establezca OPENAI_API_KEY, o que copie .env.example en el directorio de esta habilidad a .env y lo complete. Nunca le pidas que pegue la clave en el chat. Si una solicitud es bloqueada por moderación, reporta el motivo que imprime el script y sugiere un prompt reformulado. No reintentes el mismo prompt.

Cómo escribir prompts

  • Di para qué sirve cada imagen de entrada, en orden: "La PRIMERA imagen es una REFERENCIA DE COLOR SOLAMENTE. No copies su diseño, formas ni texto. La SEGUNDA imagen es la foto a editar. Mantén su encuadre y formato."
  • Da una tarea clara, luego enumera exactamente qué cambiar, con valores concretos (colores hex, materiales, posiciones).
  • Enumera lo que debe permanecer igual. Para ediciones, di "Mantén todo lo demás exactamente como está" y nombra las cosas que no deben cambiar: ángulo de cámara, iluminación, fondo, personas, otros edificios.
  • Cita cualquier texto que deba aparecer, deletreado exactamente ("dice exactamente "ES SEBELAS""). Pide poco texto: los modelos de imagen escriben mal el texto largo.
  • Nombra el estilo: fotorrealista, vector plano, acuarela, render 3D, etc.
  • Termina con una línea "Evitar:" para el fallo que esperas, como texto adicional, copiar el diseño de la referencia, o cambiar cualquier cosa fuera del objetivo.
  • Logotipos e iconos sobre fondo liso o transparente: --background transparente --format png.

Skills relacionados