CommunityImagengithub.com

animated-email-signature

Crea una firma de correo electrónico animada para cualquier sitio web empresarial (lee las páginas, el logotipo, los colores y las imágenes del sitio, luego construye un pequeño GIF en bucle que muestre el negocio en funcionamiento, junto con una página de equipo donde cada persona escriba su nombre y cargo y copie una firma lista para pegar) y luego despliégala en el propio sitio web de la empresa. Úsalo cada vez que alguien quiera una firma de correo electrónico animada, en movimiento, GIF o 'con marca', un banner de firma, una firma para todo su equipo o una página donde el personal pueda generar su firma para Gmail, Outlook o Apple Mail, incluso si no dice 'GIF'.

¿Qué es animated-email-signature?

El skill Animated Email Signature crea firmas de correo electrónico animadas y con marca para equipos, y las despliega en el sitio web de la empresa. Utiliza Playwright para inspeccionar el sitio web, extrayendo colores, logotipos, fuentes e imágenes para generar un GIF de bucle de 1200×340 (mostrado a 480×136, ~11 s, <1 MB) que muestra el negocio en acción. También genera una página de equipo donde los empleados pueden escribir su nombre, cargo y dirección de correo electrónico, y copiar una firma con el GIF incrustado, que funciona en Gmail, Outlook y Apple Mail. El skill maneja las limitaciones del correo electrónico, como la imposibilidad de usar scripts o CSS animado, garantizando que el GIF comience y termine en el cuadro de marca completo para que Outlook de escritorio muestre una tarjeta completa. Está diseñado para plataformas como Claude Code, Cursor y Codex, y guía al usuario a través de la inspección del sitio, la creación de borradores de la historia (escenas de chat, contador o exhibición), la renderización y la implementación en el sitio, todo ello dentro de las restricciones de tamaño de archivo y correo electrónico.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/him4318/animated-email-signature/tree/HEAD

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

Firma de correo electrónico animada

Crearás dos elementos para la marca del usuario y los colocarás en su sitio web:

  1. 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.
  2. 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 desde brand.json
  • assets/signature-page.html: la página del equipo
  • assets/brand.example.json: un ejemplo de marca para copiar
  • scripts/render.mjs: tarjeta → GIF, más comprobaciones de tamaño y bucle
  • scripts/build-page.mjs: brand.json → la página del equipo
  • references/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.mjs verifica 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.mjs falla 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, su palette (colores rgb realmente utilizados, clasificados por la cantidad de página que cubren, divididos en background, text, button, link) y sus fonts. Los logos e images de nivel superior enumeran los candidatos. Una lista button vacía o una fuente system-ui significa 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ágina
  • logos/: 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-icon puede ser una marca cuadrada limpia, pero verifica su px: 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 en wordmark y 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.
  • 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:
      ffmpeg -i site-brief/images/00.png -vf "crop=900:675:500:110" crop-1.png
      
      Aquí crop=w:h:x:y selecciona un cuadro 4:3 alrededor del producto. Luego abre el resultado para verificarlo.
  • 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:

EscenaSe adapta aCampos de la historia
chatsoftware, agentes de IA, aplicaciones, servicios que responden o arreglan algoquestion (≤ 32 caracteres), tres steps de `{ text ≤ 34, status: "ok"
counteruna cifra pública real: dinero manejado, pedidos enviados, clientes atendidos, años de funcionamientolabel (≤ 40), value (número), prefix/suffix (ej. "₹", "+", " pedidos"), decimals, result (≤ 28), details
showcasetiendas, comida, viajes, estudios, portafolios, productos físicos: cualquier cosa mejor mostrada que contadaitems: 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, siteUrl y gifUrl, la dirección absoluta donde vivirá el GIF (por ejemplo https://su-sitio.com/email/signature.gif).
  • Texto: tagline, aproximadamente cinco palabras que digan lo que hace el negocio. Opcionalmente email, 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) y wordmark (opcional).
  • Fuentes: nombres de familias de Google Fonts. brief.json enumera 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 fonts para 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, muted y subtle: texto, del más fuerte al más tenue. Necesitan un contraste claro sobre bg.
    • accent: el color de la marca.
    • good y bad: 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.

Skills relacionados