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:
| Archivo | Tamaño | Qué es |
|---|---|---|
og.png | 1200×630 | La vista previa de enlace para la página de inicio. |
og-<id>.png | 1200×630 | Opcional: una por página de un sitio, mismo diseño, título de esa página. |
ph/01-<id>.png … 06 | 1270×760 | Galería de Product Hunt, de 4 a 6 diapositivas. La diapositiva 1 es la heroína. |
x-header.png | 1500×500 | Cabecera X con zonas libres para avatar y recorte de móvil. |
meta.html | Las 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:imageactual 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,AccentColordel catálogo de recursos, definiciones deColoren Swift. Toma los valores claro. Escribe hex (#0d7f76); conviertergb(),oklch()yhsl()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 alaunch-assets, onull),fonts.google(comoGeist:wght@400;600, onull). 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 recursosAppIcon, la carpeta favicon. Obligatorio: el icono y el nombre aparecen en cada imagen.siteUrl: a dónde apuntameta.htmllas URLs de las imágenes. Opcional; sin él, las etiquetas llevan un marcador de posición.
Pasos
-
Capturas. Reutiliza las existentes:
launch-assets/captures/,screenshotDirs, o unlaunch-assets/store-screenshots/shots.jsonanterior. 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 yPackage.swift; por ejemploMyApp --snapshot <dir>oMYAPP_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 ejecutaswift <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, luegoxcrun simctl io booted screenshot capture.png, luegoxcrun 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
ImageRendererde 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 concrop.
Hecho cuando cada captura cumple la lista. Lee el tamaño de cada archivo (
sips -g pixelWidth -g pixelHeight) y míralo. -
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>; escribealten 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
rgcontra el contenido del sitio antes de mantenerla. - 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
-
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,phoxpara saltarte ese tipo. Las rutas son relativas aog.json. Una página hereda todo delink(captura, recorte, diseño) y sobrescribe lo que nombre. Opciones enlink, una página, una diapositiva ox:capture(ocaptures, hasta 3, apiladas),crop({ x, y, w, h }, de 0 a 1 de la captura después de recortar los márgenes transparentes;cropspara varias capturas),clean,square,radius,width(ancho de la captura como proporción de la tarjeta),shadow: false,minCoverage.layout: las tarjetas de enlace sonside(título a la izquierda, una ventana que se eleva desde la parte inferior derecha) obelow(título centrado, una captura ancha debajo). Por defecto eligebelowpara una captura más ancha que 2:1,sideen caso contrario. Las diapositivas sonfit(toda la captura, sin recortes),bleed(recortada por el borde inferior, para una ventana) opair(2 o 3 capturas apiladas). Una diapositiva sinlayouty una captura de ventana simple (sinclean) esbleed; cualquier otra cosa esfit.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. -
Renderiza.
node <carpeta-skill>/scripts/render.mjs launch-assets/og/og.jsonUna línea de salida por PNG:
okoFAIL, 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|xrenderiza un tipo (cualquier otra cosa falla). También escribemeta.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 defonts.familydebe ser la fuente que dibujó el título ("Inter, sans-serif"sin archivo dibujaría SF Pro: FAIL). Una pila que comienza con-apple-systemosystem-uisignifica la fuente del sistema y solo falla en una sustitución como Helvetica o Arial. Corrige cadaFAILenog.jsony renderiza de nuevo. -
Pase de control de calidad. Obligatorio, y se hace sobre los archivos, no sobre la configuración.
- Tamaño y alfa:
sips -g pixelWidth -g pixelHeight -g hasAlpha <cada archivo>. Tamaños exactos de sizes.md,hasAlpha: no. - Inspección visual: abre cada PNG con la herramienta de lectura a tamaño completo. Luego
node <carpeta-skill>/scripts/preview.mjs launch-assets/ogy abre_preview-600.pngy_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.
- Corrige y renderiza de nuevo, luego vuelve a mirar ese archivo.
- Solo entonces informa: la lista de archivos, la salida de
sipsy cualquier cosa que no hayas podido verificar. Indica al usuario que copie los PNG al sitio, peguemeta.htmlen<head>, y actualice la vista previa en caché en el depurador de cada plataforma.
- Tamaño y alfa:
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.