Firma de correo electrónico animada
Crearás dos elementos para la marca del usuario y los colocarás en su sitio web:
- Un GIF en bucle (1200×340, mostrado a 480×136, aproximadamente 11 s, menos de 1 MB). Comienza con la tarjeta de marca (logotipo, nombre, eslogan, dominio), muestra el producto realizando un trabajo real y regresa a la tarjeta de marca.
- Una página de equipo donde cada persona escribe su nombre, cargo y correo electrónico, ve la firma en una bandeja de entrada clara y otra oscura, y la copia. El nombre y el cargo permanecen como texto vivo, por lo que un solo GIF sirve para todo el equipo. La página indica a los motores de búsqueda y rastreadores de IA que se mantengan alejados.
La carpeta del skill contiene:
scripts/inspect-site.mjs: lee el sitio web (páginas, colores, fuentes, logotipos, imágenes, capturas de pantalla)assets/card.html: la animación, con tres escenas (chat, contador, exhibición), completadas desdebrand.jsonassets/signature-page.html: la página del equipoassets/brand.example.json: un ejemplo de marca para copiarscripts/render.mjs: tarjeta → GIF, más comprobaciones de tamaño y buclescripts/build-page.mjs: brand.json → la página del equiporeferences/deploy.md: cómo colocar ambos en el sitio; léelo en el paso 6
Por qué está construido de esta manera
Conocer estos detalles te permite tomar buenas decisiones cuando una marca no se ajusta a la plantilla:
- El correo electrónico no puede ejecutar código. Gmail, Outlook y Apple Mail eliminan scripts, videos y animaciones CSS de las firmas, por lo que el único movimiento que sobrevive en todas partes es un GIF animado.
- Outlook de escritorio antiguo muestra solo el primer fotograma. Por lo tanto, el fotograma 0 debe ser la tarjeta de marca completa, nunca un fotograma en blanco o a medio dibujar. El bucle también termina exactamente en esa tarjeta, por lo que el reinicio no tiene un salto visible.
render.mjsverifica ambos. - El tamaño importa. Las firmas grandes se recortan o se cargan lentamente, así que mantén el GIF por debajo de 1 MB. Un GIF almacena solo los píxeles que cambian entre fotogramas, por lo que cualquier cosa que cambie un área grande en cada fotograma infla el archivo. En una compilación real, un brillo suave y pulsante detrás del logotipo aumentó el GIF de 434 KB a 1.26 MB. Prefiere el movimiento en áreas pequeñas: texto escribiéndose, íconos, fundidos cortos.
render.mjsfalla por encima de 1 MB. - Dibujado a 2×, mostrado a tamaño fijo. Eso lo mantiene nítido en pantallas retina. El HTML de la firma establece
width="480" height="136"para que la aplicación de correo nunca lo muestre al ancho de archivo de 1200 px. - La firma copiada debe apuntar a la dirección https absoluta del GIF en vivo. Una aplicación de correo no puede cargar un archivo local ni una ruta relativa. La página siempre copia
gifUrl, incluso cuando previsualiza un archivo local. - El nombre no tiene color propio. Toma el color de texto de la bandeja de entrada, por lo que se lee tanto en modo claro como oscuro. La segunda línea y el enlace de correo electrónico usan colores de tono medio que se leen en ambos.
- La historia muestra solo lo que el producto realmente hace. Una firma llega a clientes e inversores, por lo que una característica o número inventado en ella es una afirmación falsa en cada correo electrónico que el equipo envía. Obtén la historia del propio sitio o documentación del producto y obtén la aprobación del usuario antes de renderizar.
Pasos
1. Configurar una carpeta de trabajo
Usa una carpeta fuera del repositorio del sitio web, para que las herramientas no terminen en su sitio:
mkdir email-signature-work && cd email-signature-work
npm init -y
npm i playwright
npx playwright install chromium
Verifica ffmpeg con ffmpeg -version. Para instalarlo: en macOS brew install ffmpeg, en Windows winget install Gyan.FFmpeg, en Linux sudo apt install ffmpeg.
Ejecuta cada comando siguiente desde esta carpeta. brand.json, el resumen del sitio, las imágenes recortadas y los resultados viven aquí, junto a node_modules.
2. Leer el sitio web
node <carpeta del skill>/scripts/inspect-site.mjs https://su-sitio.com site-brief --pages 6
Abre la página de inicio y hasta 6 páginas más (productos, características, acerca de, precios primero) y escribe site-brief/:
brief.json:pages[]tiene el título, la descripción, los encabezados, el texto principal y las etiquetas de botones de cada página, supalette(colores rgb realmente utilizados, clasificados por la cantidad de página que cubren, divididos enbackground,text,button,link) y susfonts. Loslogoseimagesde nivel superior enumeran los candidatos. Una listabuttonvacía o una fuentesystem-uisignifica que el sitio no las expuso: toma el acento de las capturas de pantalla y elige las fuentes a ojo.screens/: una captura de pantalla de cada páginalogos/: cada candidato a logotipo (SVG o imagen del encabezado, íconos de aplicaciones, imagen social)images/: las imágenes de contenido más grandes (productos, platos, proyectos, capturas de pantalla de aplicaciones, personas)
brief.json → logos e images enumeran el tamaño en píxeles (px) de cada archivo y una note cuando es demasiado pequeño para la tarjeta o un banner ancho.
Si solo lee una página, el sitio probablemente construye sus enlaces con scripts o bloquea visitas automatizadas. Ejecútalo de nuevo con una página de producto como URL de inicio, o pregúntale al usuario.
Luego, mira realmente, como lo haría un diseñador antes de comenzar:
- Capturas de pantalla: abre las capturas de pantalla de la página de inicio y una o dos páginas de producto. Obtén la sensación (oscuro o claro, divertido o serio, fotográfico o UI plana) y qué color es el acento de la marca. El fondo de botón más utilizado suele ser el acento.
- Logotipos: abre los candidatos a logotipo.
- Un SVG del encabezado suele ser la mejor fuente. Un
apple-touch-iconpuede ser una marca cuadrada limpia, pero verifica supx: muchos sitios sirven íconos de 32×32, que se ven borrosos en la tarjeta. Cualquier cosa marcada como "demasiado pequeña para la tarjeta" queda descartada. - Verifica lo que tienes. Una marca cuadrada va en
logo. Una marca denominativa ancha va enwordmarky se muestra en la tarjeta de marca en lugar del nombre escrito. - Sin un logotipo cuadrado, la tarjeta se adapta. Con una marca denominativa, elimina la columna izquierda, para que el nombre no se muestre dos veces. Sin ninguno, dibuja la primera letra de la marca en el color de acento.
- No uses un favicon de menos de 64 px ni un recorte borroso: pide un archivo al usuario.
- Los logotipos hechos para un encabezado blanco pueden desaparecer en una tarjeta oscura. Si eso sucede, usa una tarjeta clara, pide una versión clara o edita el relleno de un SVG.
- Un SVG del encabezado suele ser la mejor fuente. Un
- Imágenes: abre las imágenes candidatas para una escena de exhibición. Omite fotos de archivo, rostros de personas (pregunta primero) y cualquier cosa con texto pequeño que no se lea a 168×126.
- El fotograma se recorta para llenar (aproximadamente 4:3). Los banners de héroe anchos suelen tener texto y botones integrados, y recortarlos deja fragmentos de letras. Recorta tú mismo al sujeto primero:
Aquíffmpeg -i site-brief/images/00.png -vf "crop=900:675:500:110" crop-1.pngcrop=w:h:x:yselecciona un cuadro 4:3 alrededor del producto. Luego abre el resultado para verificarlo.
- El fotograma se recorta para llenar (aproximadamente 4:3). Los banners de héroe anchos suelen tener texto y botones integrados, y recortarlos deja fragmentos de letras. Recorta tú mismo al sujeto primero:
- Texto: lee el texto principal y los encabezados. Obtén lo que el negocio realmente hace por un cliente, en sus palabras, y cualquier cifra real que declare públicamente (clientes atendidos, pedidos entregados, años de funcionamiento).
Si el sitio bloquea el script (muro de inicio de sesión, protección contra bots) o es escaso, pídele al usuario el logotipo, los colores y una frase sobre lo que hace el negocio.
3. Elegir la escena y escribir la historia, luego obtener aprobación
brand.json → story.type elige una de tres escenas. Elige la que muestre este negocio haciendo su trabajo más claramente:
| Escena | Se adapta a | Campos de la historia |
|---|---|---|
chat | software, agentes de IA, aplicaciones, servicios que responden o arreglan algo | question (≤ 32 caracteres), tres steps de `{ text ≤ 34, status: "ok" |
counter | una cifra pública real: dinero manejado, pedidos enviados, clientes atendidos, años de funcionamiento | label (≤ 40), value (número), prefix/suffix (ej. "₹", "+", " pedidos"), decimals, result (≤ 28), details |
showcase | tiendas, comida, viajes, estudios, portafolios, productos físicos: cualquier cosa mejor mostrada que contada | items: 2–3 de { image: "site-brief/images/03.jpg", title ≤ 22, text ≤ 36 }. Las fotos son la parte más pesada de un GIF: en pruebas, 2 fotos ocuparon aproximadamente 790 KB, 3 aproximadamente 940 KB y 4 superaron 1 MB. |
La cifra de un contador debe ser una que el negocio ya declare públicamente (en su propio sitio), con la aprobación del usuario. Nunca inventes una. Una exhibición usa las imágenes del propio negocio de su sitio, no imágenes de archivo.
Para agregar una escena diferente (un antes/después, una ruta de pin de mapa, una barra de progreso), agrega una entrada a SCENES en una copia de card.html y renderiza con --card tu-card.html. Mantén las reglas en "Por qué está construido de esta manera".
Escribe brand.json (copia assets/brand.example.json; las rutas de las imágenes son relativas a brand.json):
- Nombre, dominio, URLs:
name,domain,siteUrlygifUrl, la dirección absoluta donde vivirá el GIF (por ejemplohttps://su-sitio.com/email/signature.gif). - Texto:
tagline, aproximadamente cinco palabras que digan lo que hace el negocio. Opcionalmenteemail, el correo electrónico de marcador de posición que se muestra en la página del equipo. - Imágenes:
logo(una marca cuadrada, opcional) ywordmark(opcional). - Fuentes: nombres de familias de Google Fonts.
brief.jsonenumera las fuentes del propio sitio.- Si están en Google Fonts, úsalas.
- Si son propietarias o autoalojadas, elige la fuente de Google más cercana por sensación: una sans redondeada para una sans redondeada, una serif para una serif.
- Omite
fontspara usar fuentes del sistema.
- Colores:
colors, construidos a partir de la paleta del sitio:bg: el fondo de la tarjeta. Un tono oscuro de la marca se lee bien en bandejas de entrada claras y no deslumbra en las oscuras. Una tarjeta clara también funciona, si el sitio es claro.card: un color de panel ligeramente diferente.line: bordes.text,mutedysubtle: texto, del más fuerte al más tenue. Necesitan un contraste claro sobrebg.accent: el color de la marca.goodybad: un verde y un rojo.link: un acento lo suficientemente oscuro para leerse sobre una bandeja de entrada blanca.
Establece story.type a la escena que elegiste; por defecto es chat.
Muestra el plan al usuario antes de renderizar y espera su aprobación. Incluye la escena, las líneas de la historia (o las imágenes elegidas con leyendas) y qué logotipo usarás.
4. Renderizar y mirarlo
node <carpeta del skill>/scripts/render.mjs brand.json signature.gif
Imprime el tamaño y las líneas PASS, escribe signature-last.png (el final del bucle, que debe coincidir con el primer fotograma), falla si el texto se sale del borde, el archivo supera 1 MB o el bucle no termina en el primer fotograma, y escribe signature-first.png, el fotograma que muestra el Outlook antiguo. Abre esa imagen y dos o tres fotogramas intermedios, y verifica:
- nada está cortado en el borde derecho (el texto largo es la causa habitual)
- el logotipo es nítido
- los colores se leen
- el primer fotograma es una tarjeta completa
Para extraer un fotograma a, por ejemplo, 5 s, ejecuta ffmpeg -ss 5 -i signature.gif -frames:v 1 frame5.png. Corrige y vuelve a renderizar hasta que pase y se vea bien. Si supera 1 MB, elimina primero el movimiento de área grande. Bajar --fps 12 es un último recurso.
Muestra al usuario el primer fotograma y un fotograma intermedio (o el GIF mismo) antes de continuar.
5. Construir la página del equipo
node <carpeta del skill>/scripts/build-page.mjs brand.json email-signature.html
Para previsualizarla antes del despliegue, ejecuta npx serve . en la carpeta de trabajo y abre http://localhost:3000/email-signature?preview=signature.gif. Omite .html: serve redirige las direcciones .html y elimina la parte ?preview, y la página entonces intenta cargar el GIF que aún no está en vivo. El parámetro preview solo cambia lo que muestra la página; la firma copiada sigue apuntando a gifUrl. Pruébalo con un nombre largo y con caracteres como < y &, que deben mostrarse tal como se escribieron.
6. Desplegar
Lee references/deploy.md. Cubre dónde van los dos archivos para stacks comunes (hosts estáticos, Next.js, Astro, WordPress, Webflow y otros), dónde alojar el GIF cuando el usuario no puede colocar archivos en su sitio, la línea robots.txt y qué verificar una vez que esté en vivo. Sigue la forma normal del sitio de enviar cambios: una rama y solicitud de extracción si es un repositorio git. No hagas push ni despliegues sin la aprobación del usuario.
7. Entregar
Dile al usuario:
- Enlaces: la dirección de la página para compartir con el equipo, y la dirección del GIF.
- Verificado: lo que verificaste tú mismo, como las comprobaciones de renderizado, los fotogramas que miraste y la vista previa de la página.
- Pendiente de verificar después del despliegue: pegar en Gmail, Outlook y Apple Mail, desde la lista en
deploy.md. Nada sobre aplicaciones de correo reales se puede verificar antes de que el GIF esté en vivo, así que dilo claramente en lugar de insinuar que funciona. - Actualizar más tarde: edita
brand.json, vuelve a renderizar y reemplaza el GIF en la misma dirección. La firma de todos se actualiza por sí sola, aunque las cachés de imágenes de las aplicaciones de correo pueden tardar un día o más.