CommunityImagengithub.com

og-images

Genera imágenes de lanzamiento a partir de la interfaz real de la aplicación: vistas previas de enlaces de 1200×630 (Open Graph y X card) con título grande legible, icono y captura real, vistas previas opcionales por página del sitio, galería de Product Hunt de 4 a 6 diapositivas a 1270×760, cabecera X de 1500×500 con zonas libres para avatar y recorte de móvil. Produce también las metaetiquetas para pegar.

¿Qué es og-images?

Este skill genera automáticamente imágenes de lanzamiento profesionales basadas en la interfaz real de la aplicación, sin dibujar ni generar UI falsa. Produce vistas previas de enlaces (Open Graph y X card) a 1200×630, galerías para Product Hunt (1270×760, de 4 a 6 diapositivas) y cabeceras X (1500×500). Cada imagen incluye un título grande y legible (máximo 9 palabras), el icono de la app y una captura real de la interfaz, todo sobre un fondo de marca o un wallpaper integrado. El skill verifica automáticamente que los archivos cumplan con requisitos estrictos: tamaño exacto, sin canal alfa, contraste de texto ≥4.5:1, altura de título mínima, zonas seguras libres, sin fallback de fuente, y cobertura de captura suficiente. Admite configuraciones por página para sitios web, y puede reutilizar capturas existentes o tomar nuevas con Playwright. Está diseñado para usuarios de Claude Code, Cursor, Codex y herramientas similares que necesiten imágenes de lanzamiento profesionales sin esfuerzo manual.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abdiraimov-otabek/claude-code-og-image-skill/tree/main/skills/og-images

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

Og images

Tres tipos de imagen que hacen un mismo trabajo: lograr que alguien se detenga en un enlace y entienda la aplicación de un vistazo. Cada una es una captura real de la aplicación con un título grande, sobre el fondo de la marca o un wallpaper brillante. La interfaz es la protagonista. No se dibuja nada excepto el marco.

Salidas, en launch-assets/og/ del repositorio del usuario:

ArchivoTamañoQué es
og.png1200×630La vista previa de enlace para la página de inicio.
og-<id>.png1200×630Opcional: una por página de un sitio, mismo diseño, título de esa página.
ph/01-<id>.png … 061270×760Galería de Product Hunt, de 4 a 6 diapositivas. La diapositiva 1 es la heroína.
x-header.png1500×500Cabecera X con zonas libres para avatar y recorte de móvil.
meta.htmlLas etiquetas <meta> para pegar en <head>.

Tamaños, zonas seguras, fuentes y fechas están en references/sizes.md.

Cuándo usarlo

  • El lanzamiento necesita una imagen para compartir, una galería de Product Hunt o una cabecera X.
  • La og:image actual del sitio es un logo sobre un color plano, o no existe.
  • Un lanzamiento cambió la interfaz, por lo que las vistas previas se regeneran desde capturas nuevas.

Las capturas son ventanas o islas en estilo macOS apaisado; una pantalla de teléfono en vertical no es compatible con estas tarjetas. No para: capturas de pantalla de App Store (otro skill, con otros tamaños), ni nada que necesite una interfaz que la aplicación no tenga. Este skill nunca dibuja interfaz.

Configuración (una vez)

Node 20 o más reciente. Playwright va a la carpeta de este skill, no al repositorio del usuario:

npm install --prefix <carpeta-skill> [email protected] && npx --prefix <carpeta-skill> playwright install chromium

Si falta, render.mjs imprime esta línea y termina con código 2.

Paso 0. Marca

Lee launch-assets/brand.json en el repositorio del usuario. Si existe, úsalo. Si falta, detecta cada campo a partir del repositorio y escribe el archivo. Pregunta al usuario solo por lo que no puedas encontrar, en un mensaje.

{
  "appName": "Halo", "oneLiner": "The Dynamic Island for Mac", "platform": "macos",
  "colors": { "bg": "#f5f5f7", "ink": "#1d1d1f", "accent": "#0071e3" },
  "fonts": { "family": "-apple-system, 'SF Pro Display', sans-serif", "file": null, "google": null },
  "iconPath": "site/assets/icon.png",
  "screenshotDirs": ["launch-assets/captures"],
  "siteUrl": "https://example.com"
}
  • appName, oneLiner: título y primera línea del README, <title> y <h1> del sitio, Info.plist.
  • colors: variables CSS del sitio, AccentColor del catálogo de recursos, definiciones de Color en Swift. Toma los valores claro. Escribe hex (#0d7f76); convierte rgb(), oklch() y hsl() primero. Cualquier cosa que el motor de renderizado no pueda leer cuenta como gris.
  • fonts.family (una pila CSS), fonts.file (un archivo de fuente que el repositorio incluye, una ruta relativa a la raíz del repositorio, la carpeta superior a launch-assets, o null), fonts.google (como Geist:wght@400;600, o null). Usa la fuente de la marca solo si el repositorio incluye el archivo; de lo contrario, la pila del sistema o Google Fonts. Nunca copies una fuente propietaria en el repositorio del usuario.
  • iconPath: el icono de la aplicación, un PNG cuadrado (1024 px es lo mejor), relativo a la raíz del repositorio. Búscalo en los recursos del sitio, el catálogo de recursos AppIcon, la carpeta favicon. Obligatorio: el icono y el nombre aparecen en cada imagen.
  • siteUrl: a dónde apunta meta.html las URLs de las imágenes. Opcional; sin él, las etiquetas llevan un marcador de posición.

Pasos

  1. Capturas. Reutiliza las existentes: launch-assets/captures/, screenshotDirs, o un launch-assets/store-screenshots/shots.json anterior. Toma nuevas solo cuando ninguna cumpla las reglas siguientes. Primero busca la forma propia de la aplicación de capturarse a sí misma: un flag de snapshot, demo o datos de ejemplo (rg -i "demo|snapshot|screenshot|marketing" en el código fuente, el README y Package.swift; por ejemplo MyApp --snapshot <dir> o MYAPP_DEMO=1). Lee qué hace un flag antes de ejecutarlo. Nunca ejecutes nada que escanee, limpie o escriba datos reales de usuario, y nunca inicies una segunda copia de una aplicación que mantenga estado activo. Si un flag pudiera hacer cualquiera de estas cosas, detente y pregunta. De lo contrario, en un Mac, lleva la aplicación al frente en el estado que se debe mostrar y ejecuta swift <carpeta-skill>/scripts/capture-window.swift "MyApp" capture.png (la ventana más grande visible en pantalla, sin sombra, píxeles Retina; omite un notch o panel de aplicación de la barra de menús, que está en una capa de ventana superior, y lo indica). iOS: xcrun simctl status_bar booted override --time 9:41 --batteryState charged --batteryLevel 100, luego xcrun simctl io booted screenshot capture.png, luego xcrun simctl status_bar booted clear.

    Reglas para cada captura:

    • UI real, enfocada. La ventana activa: semáforos coloreados, una barra lateral iluminada. Una ventana gris y atenuada es un fallo.
    • Estable. Sin contador en medio, sin spinner, nada a medio dibujar.
    • Datos de demostración neutros. Sin nombres personales, nombres de archivos, proyectos o cuentas reales, sin nombres de productos de otras empresas (a menos que el sitio de la aplicación nombre esa integración). Usa el modo demo, nunca una captura de pantalla de algo real.
    • Modo claro si la aplicación lo tiene. Las capturas oscuras son solo para aplicaciones exclusivamente oscuras.
    • 2x píxeles. Una tarjeta muestra una captura como máximo a 1.15x de sus propios píxeles (el renderizado falla por encima de eso), por lo que una ventana necesita aproximadamente 1400 px de ancho para una vista previa de enlace y 2000 px para una diapositiva de galería.
    • Contenido real. Sin espacios vacíos, sin lorem, sin texto truncado en la parte de la que habla el título.
    • Una que se lea pequeña. La vista previa de enlace muestra la captura con aproximadamente 600 px de ancho. Elige la captura cuyo punto principal sea visible a ese tamaño (un número grande, una lista clara), no un panel de configuración denso. Recorta hasta la parte que importa.
    • Una captura de ImageRenderer de SwiftUI (una isla de una aplicación de notch) viene con marcadores de posición amarillos opacos en sus destellos de esquina: establece "clean": true. Para una isla flotando sobre la tarjeta, añade "square": true, que cuadra los destellos de esquina hasta los bordes del cuerpo. Recorta cualquier fila de notch vacía con crop.

    Hecho cuando cada captura cumple la lista. Lee el tamaño de cada archivo (sips -g pixelWidth -g pixelHeight) y míralo.

  2. Escribe las palabras.

    • Título del enlace: el eslogan de la aplicación o el título de la página, con las palabras del sitio: 9 palabras o menos, en minúscula con mayúscula inicial, sin punto, sin guión, sin !. Es el único texto grande en la tarjeta, así que cuanto más corto, más grande.
    • Páginas: si el repositorio tiene un sitio con varias páginas, ejecuta node <carpeta-skill>/scripts/pages.mjs <carpeta-sitio>. Imprime el <title> y el <h1> de cada página. Elige las páginas que merezcan una vista previa propia (las guías, la página de precios, las funciones más importantes); salta las páginas que nombren el producto de otra empresa. Toma el <h1> o el más corto de los dos, quita el sufijo del nombre del sitio y las etiquetas estilo "(2026)", mantenlo en 9 palabras. Nunca parafrasees.
    • Diapositivas: si existe launch-assets/store-screenshots/shots.json, "ph": { "fromShots": "../store-screenshots/shots.json" } reutiliza sus titulares, subtítulos, capturas y recortes (primeras 6 capturas, "limit" lo cambia). De lo contrario, escribe de 4 a 6 diapositivas: la diapositiva 1 dice qué es la aplicación, cada una de las siguientes tiene un beneficio y tiene sentido por sí sola. Titular 6 palabras o menos, un subtítulo opcional de una oración corta.
    • Título de cabecera X: el eslogan. 6 palabras o menos.
    • Texto alternativo: una oración que diga qué muestra la imagen. Por defecto es <app>: <title>. <subtitle>; escribe alt en el enlace cuando la captura añada algo que merezca la pena decir.

    El texto usa las palabras del sitio. Cada línea se toma del sitio o README y se acorta; cada número, nombre y afirmación está en el sitio. Verifica cada línea con rg contra el contenido del sitio antes de mantenerla.

  3. Escribe launch-assets/og/og.json.

    {
      "brand": "../brand.json",
      "out": ".",
      "wallpaper": "auto",
      "link": {
        "title": "Un limpiador de Mac para desarrolladores",
        "capture": "../captures/overview.png",
        "alt": "Shedi, un limpiador de Mac para desarrolladores: 43.84 GB encontrados, clasificados en seguro de limpiar y revisar primero"
      },
      "pages": [
        { "id": "xcode-deriveddata", "title": "Limpiar Xcode DerivedData", "capture": "../captures/xcode.png" }
      ],
      "ph": { "fromShots": "../store-screenshots/shots.json" },
      "x": { "title": "Un limpiador de Mac para desarrolladores", "capture": "../captures/overview.png" }
    }
    

    Omite pages, ph o x para saltarte ese tipo. Las rutas son relativas a og.json. Una página hereda todo de link (captura, recorte, diseño) y sobrescribe lo que nombre. Opciones en link, una página, una diapositiva o x:

    • capture (o captures, hasta 3, apiladas), crop ({ x, y, w, h }, de 0 a 1 de la captura después de recortar los márgenes transparentes; crops para varias capturas), clean, square, radius, width (ancho de la captura como proporción de la tarjeta), shadow: false, minCoverage.
    • layout: las tarjetas de enlace son side (título a la izquierda, una ventana que se eleva desde la parte inferior derecha) o below (título centrado, una captura ancha debajo). Por defecto elige below para una captura más ancha que 2:1, side en caso contrario. Las diapositivas son fit (toda la captura, sin recortes), bleed (recortada por el borde inferior, para una ventana) o pair (2 o 3 capturas apiladas). Una diapositiva sin layout y una captura de ventana simple (sin clean) es bleed; cualquier otra cosa es fit.
    • minCoverage: el mínimo de cobertura de UI (enlace 0.3, diapositiva 0.4, cabecera 0.12). Una captura que ocupe el 80% del ancho de la tarjeta pasa sin él (una isla o barra delgada no puede hacerse más alta). No reduzcas el mínimo para ocultar una captura pequeña: muéstrala más grande, recórtala o elige otra.
    • En una diapositiva en fromShots, añade "slides": [{ "id": "<id de captura>", ... }] para sobrescribir las opciones de una diapositiva.

    Fondo, una vez para todas las imágenes: "wallpaper": "auto" elige la imagen incluida cuyo tono sea más cercano al color de acento de la marca (azul y verde azulado, verde, cálido, rosa) e imprime la elección y por qué. Informa al usuario de la elección y por qué, y de que puede cambiarla ("wallpaper": "snow", o una ruta a su propia imagen clara y brillante, de al menos 2400 px de ancho). Un color de acento gris, o uno a más de 50 grados de cada imagen, obtiene el fondo de marca en su lugar (el fondo de la marca lavado con un poco de su acento). Omite la clave para el fondo. Este skill incluye cinco imágenes.

  4. Renderiza.

    node <carpeta-skill>/scripts/render.mjs launch-assets/og/og.json
    

    Una línea de salida por PNG: ok o FAIL, tamaño, peso del archivo, la fuente que realmente dibujó el título, el contraste de las palabras contra los píxeles realmente detrás de ellas, el tamaño del título y la altura de mayúsculas, la cobertura de UI y cuánto se ampliaron la captura y el wallpaper. --only link|pages|ph|x renderiza un tipo (cualquier otra cosa falla). También escribe meta.html.

    La protección falla: un tamaño que no es exacto, un canal alfa, un archivo de más de 5 MB, contraste de texto inferior a 4.5:1 (no hay velo; elige un wallpaper más claro o tinta más oscura), un título cuya altura de mayúsculas está por debajo del mínimo (enlace 40 px, diapositiva 38 px, cabecera 36 px, para que aún se lea en una vista previa de 600 px de ancho) o que necesita más líneas de las que caben, texto demasiado largo o con guión (un guión, " - " o "--") o con !, una captura ampliada más de 1.15x o un wallpaper más de 1.2x, cobertura de UI por debajo del mínimo a menos que la captura ocupe el 80% del ancho de la tarjeta (medida sobre los píxeles de contenido de la captura, no sobre su caja, por lo que las áreas negras o blancas vacías no cuentan), cualquier cosa fuera del área segura de X o dentro de la zona del avatar, y una sustitución de fuente: la primera familia nombrada de fonts.family debe ser la fuente que dibujó el título ("Inter, sans-serif" sin archivo dibujaría SF Pro: FAIL). Una pila que comienza con -apple-system o system-ui significa la fuente del sistema y solo falla en una sustitución como Helvetica o Arial. Corrige cada FAIL en og.json y renderiza de nuevo.

  5. Pase de control de calidad. Obligatorio, y se hace sobre los archivos, no sobre la configuración.

    1. Tamaño y alfa: sips -g pixelWidth -g pixelHeight -g hasAlpha <cada archivo>. Tamaños exactos de sizes.md, hasAlpha: no.
    2. Inspección visual: abre cada PNG con la herramienta de lectura a tamaño completo. Luego node <carpeta-skill>/scripts/preview.mjs launch-assets/og y abre _preview-600.png y _preview-300.png (cada imagen a 600 y 300 px de ancho, como la mostraría un feed), luego borra los dos archivos. Para cada imagen verifica:
      • El título es legible a 300 px y nada está recortado o solo en una segunda línea.
      • La fuente en la línea de salida es la que pediste.
      • La captura es nítida, muestra el punto del título, no tiene texto truncado ni datos personales.
      • Nombres: sin nombre o logotipo de competidor u otra empresa a menos que el sitio nombre esa integración; sin nombres personales.
      • Texto: cada línea es la redacción del sitio, acortada; cada número está en el sitio.
      • Cabecera X: la parte inferior izquierda (x inferior a 420, y superior a 300) está libre para la foto de perfil; el contenido está en la banda central, alejado de los 70 px superior e inferior. Verifícalo contra sizes.md y, si puedes, en el perfil real.
      • Conjunto: las diapositivas se leen como una familia; ninguna repite el mismo punto.
    3. Corrige y renderiza de nuevo, luego vuelve a mirar ese archivo.
    4. Solo entonces informa: la lista de archivos, la salida de sips y cualquier cosa que no hayas podido verificar. Indica al usuario que copie los PNG al sitio, pegue meta.html en <head>, y actualice la vista previa en caché en el depurador de cada plataforma.

Reglas de aspecto visual

  • Claro primero. Un wallpaper brillante o el fondo de marca, tinta oscura sobre él. Sin fondo oscuro con neón.
  • Sin brillo, sin halo. La profundidad es un borde de 1 px y sombras negras neutras a baja opacidad.
  • Un trabajo por imagen. Un título, una captura (o un par), como máximo un subtítulo.
  • Tipo grande. El título es lo que sobrevive a una miniatura. El texto corto permite que sea grande.
  • Solo capturas reales. La interfaz nunca se dibuja, redibuja ni genera.

Skills relacionados