Communitygithub.com

brainzcode/premium-landing

Crea vistas previas de enlaces y favicons que realmente funcionan: etiquetas Open Graph y Twitter Card, una imagen de compartir correctamente enmarcada de 1200x630, y un conjunto completo de favicons (SVG, ICO, apple-touch, máscara adaptable). Úsalo cuando se te pida compartir en redes sociales, imagen OG, Open Graph, Twitter Card, vista previa de enlace, imagen para compartir, favicon, icono de app, icono de apple touch o manifiesto web. También cuando una vista previa de enlace compartido se muestre en blanco, muestre la imagen equivocada, o un favicon no aparezca. Incluye la trampa de la URL absoluta que silenciosamente deja todas las vistas previas en blanco y la trampa de las fuentes que rompe los favicons SVG en otras máquinas.

¿Qué es premium-landing?

Este skill proporciona una guía exhaustiva y herramientas para implementar correctamente las vistas previas de enlaces compartidos (Open Graph y Twitter Cards) y todos los formatos de favicon necesarios para aplicaciones web modernas. Está diseñado para desarrolladores que necesitan asegurarse de que sus enlaces se vean bien en redes sociales como Facebook, X (Twitter), LinkedIn y Slack, y que los favicons funcionen correctamente en todos los navegadores y plataformas móviles. La documentación cubre desde las etiquetas HTML esenciales hasta scripts de generación de imágenes, manejo de la imagen de compartir en la proporción correcta (1200x630), creación de un conjunto completo de favicons (ICO, SVG, PNG para iOS y Android, y máscara adaptable), y la configuración del manifiesto web. También advierte sobre trampas comunes, como la necesidad de usar URLs absolutas, evitar texto en favicons SVG, y manejar correctamente el área segura para iconos de máscara adaptable. Al final, incluye un script de verificación y consejos sobre el caché de las plataformas y dominios de marcador de posición.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brainzcode/premium-landing/tree/HEAD/plugins/premium-landing/skills/social-share-favicons

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Compartir en redes sociales y favicons

Lo único que importa

og:image y og:url deben ser URLs absolutas en un host accesible públicamente.

El rastreador las obtiene desde sus propios servidores. No tiene contexto de página, ni cookies, ni referer, ni idea de a qué se refiere tu ruta relativa. Una ruta como /assets/og.jpg o assets/og.jpg se resuelve a nada y la tarjeta vuelve en blanco.

<!-- muerto: renderiza una tarjeta vacía en todas partes -->
<meta property="og:image" content="assets/images/og-image.jpg">

<!-- funciona -->
<meta property="og:image" content="https://ejemplo.com/assets/images/og-image.jpg">

Esta es la razón más común por la que una vista previa no funciona. Antes de depurar cualquier otra cosa, confirma que la URL sea absoluta y cargue en una ventana privada.

El corolario: las vistas previas no pueden funcionar en localhost o file://. Nada de lo que hagas localmente producirá una vista previa real. Despliega primero, luego valida.

El conjunto de etiquetas

<link rel="canonical" href="https://ejemplo.com/">

<meta property="og:type"        content="website">
<meta property="og:site_name"   content="Marca">
<meta property="og:locale"      content="es_ES">
<meta property="og:url"         content="https://ejemplo.com/">
<meta property="og:title"       content="Marca - lo que es">
<meta property="og:description" content="Una oración. Alrededor de 110 caracteres.">
<meta property="og:image"       content="https://ejemplo.com/og-image.jpg">
<meta property="og:image:type"  content="image/jpeg">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt"   content="Lo que hay en la imagen.">

<meta name="twitter:card"        content="summary_large_image">
<meta name="twitter:title"       content="Marca - lo que es">
<meta name="twitter:description" content="Una oración. Alrededor de 110 caracteres.">
<meta name="twitter:image"       content="https://ejemplo.com/og-image.jpg">
<meta name="twitter:image:alt"   content="Lo que hay en la imagen.">

Tres detalles que son fáciles de equivocar:

og: usa property=, twitter: usa name=. Mezclarlos se ignora silenciosamente, por lo que las etiquetas parecen presentes en el código fuente y no hacen nada. Algunos parsers toleran name= en og:, pero no confíes en ello.

twitter:card debe ser summary_large_image. El valor por defecto es una tarjeta cuadrada pequeña con la imagen como miniatura junto al texto, lo que desperdicia una imagen de 1200x630.

Declarar og:image:width y og:image:height hace que la tarjeta se renderice inmediatamente. Sin ellos, la plataforma tiene que descargar la imagen antes de saber la relación de aspecto, por lo que la primera persona que comparte el enlace a menudo ve una tarjeta solo de texto. Deben coincidir con el archivo real. Mídelo, no asumas.

Longitud de copia: los títulos se cortan alrededor de 60 caracteres, las descripciones alrededor de 110 a 200 según la plataforma. Pon el significado al principio.

La imagen para compartir

1200x630 (1.905:1). JPEG a menos que el diseño necesite alfa, que no es el caso, ya que cada plataforma compone sobre blanco. Mantenla por debajo de 1 MB; los límites duros son 8 MB (Facebook) y 5 MB (X), pero los archivos grandes agotan el tiempo de espera durante el raspado.

Renderedla en la proporción objetivo, no recortes una captura de pantalla

Tomar una captura de pantalla arbitraria y recortarla a 1.905:1 descarta la composición que eligió el diseñador. Renderiza la fuente en la proporción en su lugar:

# 1440x756 es exactamente 1.905:1, por lo que se reduce a 1200x630 sin recortar
chrome --headless --disable-gpu --hide-scrollbars --virtual-time-budget=8000 \
  --window-size=1440,756 --screenshot=og-src.png "file://$PWD/index.html"

La trampa del viewport corto

Si la página tiene un héroe de altura completa (100vh / 100svh), renderizar directamente a 1.905:1 da un viewport mucho más corto que una pantalla de escritorio real. Cualquier medio con object-fit: cover recorta mucho más de lo que lo hace en uso real, y los elementos que normalmente se evitan chocan, típicamente un logotipo de encabezado que cae sobre la cabeza del sujeto.

Renderiza en un viewport más alto para que el medio recorte como lo hace en uso real, luego corta la ventana 1.905:1 de él:

chrome --headless ... --window-size=1440,1000 --screenshot=og-src.png "file://$PWD/index.html"
ffmpeg -i og-src.png -vf "crop=1440:756:0:0" -q:v 2 og-crop.png     # anclado arriba

Compara un recorte anclado arriba con uno centrado antes de elegir. El anclado arriba generalmente mantiene el mobiliario de la marca (barra de utilidades, navegación, marca); el centrado generalmente mantiene al sujeto y la llamada a la acción. No puedes tener ambos, porque un héroe de altura completa es más alto de lo que permite 1.905:1.

Enmarcado

Las tarjetas se renderizan alrededor de 500 px de ancho en un feed, y cada plataforma recorta de manera diferente (LinkedIn y Slack son más ajustados que Facebook). Mantén cualquier cosa que deba sobrevivir dentro del 80% central, y configura cualquier tipo lo suficientemente grande como para leerlo a la mitad del tamaño. El detalle fino de la interfaz de usuario desaparece; una marca grande y una imagen fuerte no.

Favicons

La trampa de las fuentes

No pongas <text> en un favicon SVG.

<!-- se rompe: renderiza en la fuente de respaldo que el visor tenga -->
<svg ...><text x="50%" y="50%" font-family="Geist">G</text></svg>

El SVG se renderiza en la máquina del visor, donde tu fuente web no existe. Extrae el glifo como una ruta para que sea independiente de la fuente y de la resolución. Consulta el script a continuación.

La trampa de la transparencia

Un glifo oscuro sobre un fondo transparente desaparece contra el cromo del navegador oscuro, y uno claro desaparece sobre el claro. Dibuja el icono sobre un mosaico relleno. También le da a la marca una silueta consistente en las barras de pestañas, marcadores y pantallas de inicio.

El conjunto de archivos

ArchivoTamañoPor qué
/favicon.ico16, 32, 48los navegadores solicitan esta ruta implícitamente incluso cuando declaras otras; mantenlo en la raíz web
favicon.svgescalablelo que prefieren los navegadores modernos, y se mantiene nítido en cualquier pantalla
apple-touch-icon.png180pantalla de inicio de iOS
icon-192.png192manifiesto
icon-512.png512manifiesto, pantallas de bienvenida
icon-maskable-512.png512máscaras adaptables de Android
<link rel="icon" href="/favicon.ico" sizes="32x32">
<link rel="icon" href="/assets/icons/favicon.svg" type="image/svg+xml">
<link rel="apple-touch-icon" href="/assets/icons/apple-touch-icon.png">
<link rel="manifest" href="/site.webmanifest">

La zona segura de máscara adaptable

Android recorta los iconos en formas arbitrarias (círculo, cuadrado redondeado, lágrima). Un icono maskable debe mantener todo lo significativo dentro del círculo central del 80%, lo que significa que aproximadamente el 40% del borde del mosaico es relleno desechable. Reutiliza el icono normal y se le cortarán los bordes.

En la práctica: si el glifo cubre el 60% del mosaico en el icono estándar, redúcelo a aproximadamente el 40% para el máscara adaptable. Entrega ambos, con "purpose": "any" y "purpose": "maskable" como entradas separadas. Nunca pongas ambos propósitos en un solo archivo.

Manifiesto web

{
  "name": "Marca",
  "short_name": "Marca",
  "start_url": "/",
  "scope": "/",
  "display": "standalone",
  "background_color": "#f7f6f4",
  "theme_color": "#0a0a0a",
  "icons": [
    { "src": "/assets/icons/favicon.svg", "type": "image/svg+xml", "sizes": "any" },
    { "src": "/assets/icons/icon-192.png", "type": "image/png", "sizes": "192x192", "purpose": "any" },
    { "src": "/assets/icons/icon-512.png", "type": "image/png", "sizes": "512x512", "purpose": "any" },
    { "src": "/assets/icons/icon-maskable-512.png", "type": "image/png", "sizes": "512x512", "purpose": "maskable" }
  ]
}

theme_color tiñe el cromo del navegador móvil, por lo que debe coincidir con lo que sea que esté en la parte superior de la página, no el color principal de la marca. Si la página se abre en una barra de utilidades negra, usa ese negro. Un desajuste se lee como un error de renderizado. Reflejalo en <meta name="theme-color">.

background_color es la pantalla de bienvenida detrás del icono antes de la primera pintura, por lo que debe coincidir con el fondo de la página.

Script de generación

Necesita pillow y fonttools. Produce el conjunto completo de iconos más la imagen para compartir.

import os
from PIL import Image, ImageDraw, ImageFont
from fontTools.ttLib import TTFont
from fontTools.pens.svgPathPen import SVGPathPen
from fontTools.pens.boundsPen import BoundsPen

FONT   = "marca.ttf"      # la cara de la marca real, en el peso que usa la marca
CHAR   = "G"
INK    = "#0a0a0a"        # mosaico
PAPER  = "#f2f1ed"        # glifo
COVER  = 0.60             # altura del glifo como proporción del mosaico
OUT    = "assets/icons"
os.makedirs(OUT, exist_ok=True)

# ── SVG: glifo como ruta real, para que no dependa de las fuentes del visor ──
f  = TTFont(FONT)
gs = f.getGlyphSet()
name = f.getBestCmap()[ord(CHAR)]

bp = BoundsPen(gs); gs[name].draw(bp)
x0, y0, x1, y1 = bp.bounds
pen = SVGPathPen(gs); gs[name].draw(pen)
d = pen.getCommands()

VB = 64
s  = (VB * COVER) / (y1 - y0)
tx = (VB - (x1 - x0) * s) / 2 - x0 * s
ty = (VB + (y1 - y0) * s) / 2 + y0 * s      # y se invierte: las fuentes tienen y hacia arriba, SVG tiene y hacia abajo

open(f"{OUT}/favicon.svg", "w").write(
    f'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 {VB} {VB}">'
    f'<rect width="{VB}" height="{VB}" fill="{INK}"/>'
    f'<path transform="translate({tx:.3f} {ty:.3f}) scale({s:.5f} -{s:.5f})" '
    f'd="{d}" fill="{PAPER}"/></svg>')

# ── Mosaicos rasterizados ────────────────────────────────────────────────────
def tile(px, cover=COVER):
    img = Image.new("RGB", (px, px), INK)
    dr  = ImageDraw.Draw(img)
    fnt = ImageFont.truetype(FONT, px * 2)
    bb  = dr.textbbox((0, 0), CHAR, font=fnt)
    fnt = ImageFont.truetype(FONT, int(px * 2 * (px * cover) / (bb[3] - bb[1])))
    bb  = dr.textbbox((0, 0), CHAR, font=fnt)
    dr.text(((px - (bb[2] - bb[0])) / 2 - bb[0],
             (px - (bb[3] - bb[1])) / 2 - bb[1]), CHAR, font=fnt, fill=PAPER)
    return img

tile(180).save(f"{OUT}/apple-touch-icon.png", optimize=True)
tile(192).save(f"{OUT}/icon-192.png", optimize=True)
tile(512).save(f"{OUT}/icon-512.png", optimize=True)
tile(512, cover=0.42).save(f"{OUT}/icon-maskable-512.png", optimize=True)  # zona segura del 40%
tile(256).save("favicon.ico", sizes=[(16, 16), (32, 32), (48, 48)])

# ── Imagen para compartir: recorta un renderizado más alto a la proporción, luego reduce ──
src = Image.open("og-src.png").convert("RGB")          # ej. 1440x1000
src.crop((0, 0, 1440, 756)).resize((1200, 630), Image.LANCZOS).save(
    "assets/images/og-image.jpg", quality=88, optimize=True, progressive=True)

¿No hay una fuente de marca disponible? Cualquier grotesca geométrica funciona para un monograma. Rasterizar un logotipo PNG existente sobre el mosaico también está bien; solo centrado dentro de la misma fracción COVER y mantén la variante máscara adaptable más pequeña.

Verificar antes de enviar

import re, json, os
from PIL import Image
s = open("index.html").read()
tags = dict(re.findall(r'(?:property|name)="((?:og|twitter):[^"]+)"\s+content="([^"]+)"', s))

for t in ("og:url", "og:image", "twitter:image"):
    assert tags[t].startswith("http"), f"{t} no es absoluta: {tags[t]}"

w, h = Image.open("assets/images/og-image.jpg").size
assert (str(w), str(h)) == (tags["og:image:width"], tags["og:image:height"]), "el tamaño declarado es incorrecto"
assert tags["twitter:card"] == "summary_large_image"

m = json.load(open("site.webmanifest"))
for i in m["icons"]:
    assert os.path.isfile(i["src"].lstrip("/")), f"falta el icono {i['src']}"
print("ok")

Lista de verificación:

  • og:image y og:url absolutas, en el host real, cargando en una ventana privada
  • og:image:width / height declarados coinciden con el archivo real
  • twitter:card es summary_large_image
  • las etiquetas og: usan property=, las etiquetas twitter: usan name=
  • cada dominio de marcador de posición reemplazado (búscalo con grep; generalmente hay cuatro)
  • favicon.ico en la raíz web, no solo en una carpeta de activos
  • el favicon SVG contiene un <path>, sin <text>
  • el mosaico del icono está relleno, para que sobreviva al cromo del navegador oscuro y claro
  • icono máscara adaptable rellenado al 80% central
  • theme_color coincide con el borde superior de la página

Almacenamiento en caché

Cada plataforma almacena en caché agresivamente y seguirá sirviendo la tarjeta anterior después de que la arregles. Vuelve a raspar:

LinkedIn almacena en caché con más fuerza y efectivamente ignora los cambios durante unos 7 días a menos que ejecutes el inspector. Si una URL ya se ha compartido ampliamente con una tarjeta rota, agregar una cadena de consulta (?v=2) fuerza un raspado nuevo.

Los favicons también se almacenan en caché en el navegador. Prueba en una ventana privada; una recarga normal generalmente seguirá sirviendo la anterior.

Dominios de marcador de posición

Cuando el dominio real aún no se conoce, usa un subdominio de example.com (https://brand.example.com). RFC 2606 lo reserva, por lo que es inequívocamente un marcador de posición y nunca puede apuntar accidentalmente a un dominio que alguien más posee. Nunca dejes un dominio plausible pero no propio en los metadatos enviados.

Pon la instrucción de reemplazo en un comentario directamente encima del bloque y en el README del proyecto, y di cuántas ocurrencias hay. Normalmente son cuatro: canonical, og:url, og:image, twitter:image.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

brainzcode/premium-landing

Add a studio or agency build credit to a website footer — "Site by <Studio>" linking to the studio's site. Use when finishing or shipping a site, adding a footer, or when asked for an agency credit, build credit, designed-by line, or attribution. Covers wording, placement opposite the client's copyright, markup for each stack, styling from the host site's tokens, and the sitewide-footer-link SEO footprint when the same credit runs across many client sites.

brainzcode/premium-landing

Build a complete premium landing page, either replicated from a reference screenshot/URL or designed from a written brief, in HTML, React, Next.js or Astro. Use when asked to build, design, replicate or clone a landing page, marketing page, or one-page site; when handed a design screenshot or Figma/Pinterest reference to turn into code; or when a landing page needs a full premium pass. Covers design tokens, section patterns, the layout traps that silently break grids and marquees, and screenshot-based responsive verification from 320px to 1920px.

brainzcode/premium-landing

Add Lenis smooth scrolling to a site correctly — setup, anchor offsets for sticky headers, scroll locking for modals and menus, reduced-motion handling. Use when asked for smooth scroll, Lenis, momentum/eased scrolling, or when smooth scroll broke a sticky header, a modal lock, or anchor links. Includes the sticky-position trap that only appears at non-zero scroll.

brainzcode/premium-landing

Build true Apple-style liquid glass in the browser — real refraction via SVG displacement maps, chromatic dispersion, specular edges. Use when asked for liquid glass, glassmorphism, frosted/glass cards, glass navbars, or when a blur-based "glass" effect looks flat. Includes the performance trap that makes backdrop-filter stutter on scroll and the contrast trap that makes text unreadable on glass.

brainzcode/premium-landing

Build a premium mobile nav — a hamburger button that morphs into a close X, a full-screen overlay panel with staggered link reveal, scroll lock, focus trap, and reduced-motion handling. Use when asked for a mobile menu, hamburger/burger button, nav drawer, off-canvas menu, or when a menu loses scroll position, still scrolls behind on iOS, leaks Tab focus to the page underneath, or the close button stops responding. Includes the z-index trap that swallows the close button and the iOS rubber-band trap.

brainzcode/premium-landing

Rebuild a design accurately from a supplied reference — a screenshot, PDF page, mockup or live URL — by measuring it numerically instead of eyeballing it. Use when asked to replicate, clone, match or rebuild a design "exactly", "1 to 1" or "with no mistakes", or when a build drifts from its reference. Covers extracting the true content box from a padded screenshot, deriving element positions as percentages, solving object-fit framing, and knowing when a reference cannot be matched.

brainzcode/premium-landing

Source free, licence-clear photography for a site from Unsplash — searching by mood rather than noun, sizing and cropping for the slot, honouring the API's hotlink and download-tracking requirements, and writing real alt text. Use when a page needs a hero image, section photography, avatars or card art and none was supplied; when placeholder greys need replacing with real imagery; or when asked to find, pick or swap photos for a design.

Skills relacionados