CommunityImagengithub.com

launch-social-images

Crea las imágenes de compartir e iconos que necesita un sitio Next.js App Router: una imagen Open Graph de 1200×630 generada con ImageResponse de next/og, etiquetas de tarjeta de Twitter/X, favicon, iconos de aplicación e icono de Apple Touch, además de imágenes OG por página para publicaciones de blog, y las verifica con un script de comprobación.

¿Qué es launch-social-images?

Este skill automatiza la creación de todas las imágenes sociales e iconos necesarios para un sitio web Next.js (App Router). Genera la imagen Open Graph de 1200×630 píxeles usando `ImageResponse` de `next/og`, incluye soporte para imágenes por página (como en posts de blog o productos), y configura el favicon, iconos de aplicación y el icono táctil de Apple. Es útil porque sin estas imágenes, los enlaces compartidos en plataformas como X, LinkedIn, Slack, Discord o WhatsApp aparecen sin vista previa visual, lo que reduce la tasa de clics. El skill inspecciona el proyecto existente, lee la documentación oficial de Next.js, aplica las mejores prácticas de diseño (como mantener el contenido en el área central de 1000×500 píxeles y usar Flexbox), y ofrece un script de verificación que comprueba dimensiones, tamaño de archivo, etiquetas meta y la presencia de `metadataBase`. También maneja casos especiales como exportaciones estáticas (con `output: "export"`), donde se recomienda guardar las imágenes como archivos `.png` para evitar problemas de tipo MIME. Al final, genera un reporte con los archivos creados y los resultados de la verificación.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nandot12/nextjs-launch-skills/tree/main/skills/launch-social-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

Imágenes sociales e iconos para compartir

Cuando alguien pega el enlace del sitio en X, LinkedIn, Slack, Discord o WhatsApp, debe aparecer una imagen grande con un titular legible. Los navegadores y teléfonos deben mostrar un icono nítido.

1. Inspeccionar

  • Carpeta App (src/app/ o app/), archivos existentes favicon.ico, icon.*, apple-icon.*, opengraph-image.*, twitter-image.*.
  • metadataBase en el layout raíz. Sin él, las URLs og:image son relativas y las plataformas sociales las ignoran. Si falta, agrégalo (consulta el skill launch-seo, o establece metadataBase: new URL("https://your-domain.com")).
  • next.config.*: ¿output: "export"?
  • Marca: nombre, eslogan, color primario, logotipo (SVG preferido). Reutiliza tokens de globals.css.
  • Lee la documentación de la versión correspondiente:
    • node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/opengraph-image.md
    • node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/app-icons.md
    • node_modules/next/dist/docs/01-app/03-api-reference/04-functions/image-response.md

2. Imagen Open Graph (para todo el sitio)

Copia assets/opengraph-image.tsx a app/opengraph-image.tsx y edita los valores de la marca. Exporta alt, size (1200×630) y contentType, y dibuja la imagen con ImageResponse de next/og.

Reglas de diseño para las imágenes para compartir:

  • Titular de 3 a 8 palabras, al menos 64 px, con alto contraste. Debe ser legible como una miniatura de 300 px de ancho.
  • Mantén el contenido importante dentro del área central de 1000×500 píxeles; algunas plataformas recortan los bordes.
  • Marca + nombre de dominio en una esquina para que la gente sepa a dónde va el enlace.
  • Solo Flexbox: ImageResponse soporta un subconjunto de CSS (display: flex, sin grid). Cada elemento con más de un hijo necesita display: "flex".
  • Fuentes: la fuente predeterminada funciona directamente. Para una fuente personalizada, carga un archivo .ttf/.otf/.woff (no .woff2) con readFile y pásalo en la opción fonts, como se muestra en la documentación.
  • Límite de tamaño: 8 MB para Open Graph, 5 MB para Twitter. Los PNG generados suelen tener menos de 100 KB.

twitter-image es opcional: cuando falta, X usa la imagen Open Graph. Asegúrate de que los metadatos raíz establezcan twitter: { card: "summary_large_image" }.

3. Imágenes por página (publicaciones de blog, documentación, páginas de producto)

Añade opengraph-image.tsx dentro del segmento dinámico, por ejemplo app/blog/[slug]/opengraph-image.tsx. Recibe params (una Promesa) y puede cargar el título del post; exporta generateStaticParams desde el archivo de imagen para que cada imagen se renderice previamente. Mantén la misma plantilla para que todas las imágenes compartidas parezcan de una sola marca.

Esto importa más de lo que parece: cuando una página establece su propio openGraph en metadata/generateMetadata, reemplaza el objeto openGraph del padre y la imagen de portada raíz desaparece de esa página. Un archivo opengraph-image a nivel de segmento (o openGraph.images explícito) lo soluciona.

4. Iconos

Archivo (en app/)TamañoPropósito
favicon.ico32×32 (multitamaño ok)Pestaña del navegador, requerido en la raíz de la app
icon.png o icon.svg512×512 PNG o SVGNavegadores modernos, Android
apple-icon.png180×180Pantalla de inicio de iOS

También puedes generar icon.tsx / apple-icon.tsx con ImageResponse — consulta assets/icon.tsx. Reemplaza el favicon.ico predeterminado de create-next-app antes del lanzamiento; si no hay una herramienta para .ico, un icon.png de 32×32 más la eliminación del antiguo favicon.ico es aceptable.

5. Nota sobre exportación estática

Con output: "export" (probado en Next.js 16.4):

  • cacheComponents debe estar desactivado para una exportación estática, y cada archivo de imagen generado (opengraph-image.tsx, icon.tsx, apple-icon.tsx) necesita export const dynamic = "force-static";, o la compilación falla. Los segmentos dinámicos también necesitan generateStaticParams.
  • Las imágenes generadas se exportan sin extensión de archivo (out/opengraph-image), por lo que los hosts estáticos las sirven sin cabecera Content-Type (verificado en Cloudflare Pages). Algunos rastreadores lo rechazan. La mejor solución para la imagen de todo el sitio: abre /opengraph-image en el sitio en ejecución, guárdalo y confírmalo como app/opengraph-image.png (luego elimina el .tsx); se exporta como opengraph-image.png con el tipo correcto. Lo mismo para los iconos (app/icon.png, app/apple-icon.png). Para imágenes por publicación, establece Content-Type: image/png para esas rutas en el archivo de cabeceras del host (public/_headers en Cloudflare Pages/Netlify).

6. Verificar

  1. npm run build debe pasar. La salida de compilación lista las rutas opengraph-image.

  2. Inicia el sitio (npm run start, o sirve la carpeta out/) y ejecuta el comprobador (Node 18+, sin dependencias). <skill-dir> es la carpeta que contiene este SKILL.md:

    node <skill-dir>/scripts/check-og.mjs http://localhost:3000/ http://localhost:3000/blog/some-post
    

    Lee las etiquetas og:* y twitter:* de la página, descarga la imagen y comprueba URL absoluta, estado HTTP, tamaño de archivo, dimensiones (1200×630), og:image:alt y twitter:card. Las URLs con localhost en las etiquetas se reportan, porque significan que metadataBase falta o está mal configurado para producción.

  3. Abre la URL de la imagen en el navegador y mírala. Verifica que el texto sea legible cuando la ventana del navegador es estrecha.

  4. Después del despliegue, dile al usuario que pruebe con las herramientas propias de las plataformas (LinkedIn Post Inspector, Facebook Sharing Debugger). Estas también actualizan las vistas previas en caché.

Reporte

Enumera los archivos de imagen e icono creados, la salida del comprobador y un recordatorio de que las plataformas guardan en caché las vistas previas: después de cambiar la imagen, vuelve a rastrear con las herramientas anteriores.

Skills relacionados