CommunityImagemgithub.com

assinatura-de-email-animada

Crie uma assinatura de email animada para qualquer site corporativo (leia as páginas, logotipo, cores e imagens do site, depois construa um pequeno GIF em loop que mostre o negócio em ação, além de uma página de equipe onde cada pessoa digita seu nome e título e copia uma assinatura pronta para colar) e implante-a no próprio site da empresa. Use sempre que alguém quiser uma assinatura de email animada, em movimento, GIF ou “marcada”, um banner de assinatura, uma assinatura para toda a equipe ou uma página onde os funcionários possam gerar sua assinatura para Gmail, Outlook ou Apple Mail, mesmo que não digam “GIF”.

O que é assinatura-de-email-animada?

Esta habilidade cria uma assinatura de email animada em GIF para toda a equipe de uma empresa, juntamente com uma página interna onde cada membro pode gerar sua própria assinatura personalizada. Ela inspeciona automaticamente o site da empresa (coletando cores, logotipos, fontes e imagens), gera um GIF compacto (máximo de 1 MB) com três cenas possíveis (chat, contador, vitrine), e constrói uma página de equipe com funcionalidade de cópia. A ferramenta foi projetada para contornar limitações de clientes de email (que não executam scripts, vídeos ou animações CSS), garantindo que a animação funcione no Gmail, Outlook e Apple Mail. O processo inclui etapas de aprovação do usuário para o roteiro e o GIF final, e oferece orientação detalhada de implantação em diversas plataformas (estático, Next.js, Astro, WordPress, etc.).

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

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Assinatura de email animada

Você criará duas coisas para a marca do usuário e as colocará no site dele:

  1. Um GIF em loop (1200×340, exibido em 480×136, cerca de 11 s, abaixo de 1 MB). Ele abre com o cartão da marca (logotipo, nome, slogan, domínio), mostra o produto fazendo um trabalho real e retorna ao cartão da marca.
  2. Uma página de equipe onde cada pessoa digita seu nome, cargo e email, vê a assinatura em uma caixa de entrada clara e uma escura, e a copia. Nome e cargo permanecem como texto vivo, então um GIF atende toda a equipe. A página instrui mecanismos de busca e rastreadores de IA a ficarem longe.

A pasta da habilidade contém:

  • scripts/inspect-site.mjs: lê o site (páginas, cores, fontes, logotipos, imagens, capturas de tela)
  • assets/card.html: a animação, com três cenas (chat, contador, vitrine), preenchidas a partir de brand.json
  • assets/signature-page.html: a página da equipe
  • assets/brand.example.json: um exemplo de marca para copiar
  • scripts/render.mjs: cartão → GIF, além de verificações de tamanho e loop
  • scripts/build-page.mjs: brand.json → a página da equipe
  • references/deploy.md: colocando ambos no site; leia-o na etapa 6

Por que foi construído assim

Saber disso permite que você tome boas decisões quando uma marca não se encaixa no modelo:

  • O email não pode executar código. Gmail, Outlook e Apple Mail removem scripts, vídeos e animações CSS das assinaturas, então o único movimento que sobrevive em todos os lugares é um GIF animado.
  • O Outlook desktop antigo mostra apenas o primeiro quadro. Portanto, o quadro 0 deve ser o cartão da marca finalizado, nunca um quadro em branco ou parcialmente desenhado. O loop também termina exatamente nesse cartão, para que a reinicialização não tenha um salto visível. render.mjs verifica ambos.
  • O tamanho importa. Assinaturas grandes são cortadas ou carregam lentamente, então mantenha o GIF abaixo de 1 MB. Um GIF armazena apenas os pixels que mudam entre os quadros, então qualquer coisa que mude uma grande área em todos os quadros aumenta o arquivo. Em uma construção real, um brilho suave pulsante atrás do logotipo levou o GIF de 434 KB para 1,26 MB. Prefira movimento em áreas pequenas: texto digitando, ícones, desvanecimentos curtos. render.mjs falha acima de 1 MB.
  • Desenhado em 2×, exibido em tamanho fixo. Isso o mantém nítido em telas retina. O HTML da assinatura define width="480" height="136" para que o aplicativo de email nunca o mostre na largura de arquivo de 1200 px.
  • A assinatura copiada deve apontar para o endereço https absoluto do GIF ao vivo. Um aplicativo de email não pode carregar um arquivo local ou um caminho relativo. A página sempre copia gifUrl, mesmo quando visualiza um arquivo local.
  • O nome não tem cor própria. Ele assume a cor do texto da caixa de entrada, então é legível nos modos claro e escuro. A segunda linha e o link de email usam cores de tom médio que são legíveis em ambos.
  • A história mostra apenas o que o produto realmente faz. Uma assinatura alcança clientes e investidores, então um recurso ou número inventado nela é uma afirmação falsa em cada email que a equipe envia. Obtenha a história do próprio site ou documentação do produto e obtenha a aprovação do usuário antes de renderizar.

Etapas

1. Configurar uma pasta de trabalho

Use uma pasta fora do repositório do site, para que ferramentas não acabem no site deles:

mkdir email-signature-work && cd email-signature-work
npm init -y
npm i playwright
npx playwright install chromium

Verifique o ffmpeg com ffmpeg -version. Para instalá-lo: no macOS brew install ffmpeg, no Windows winget install Gyan.FFmpeg, no Linux sudo apt install ffmpeg.

Execute todos os comandos abaixo a partir desta pasta. brand.json, o resumo do site, quaisquer imagens recortadas e as saídas ficam todos aqui, ao lado de node_modules.

2. Ler o site

node <pasta da habilidade>/scripts/inspect-site.mjs https://site-deles.com resumo-do-site --pages 6

Ele abre a página inicial e até 6 páginas adicionais (produtos, recursos, sobre, preços primeiro) e escreve resumo-do-site/:

  • brief.json: pages[] tem o título de cada página, descrição, cabeçalhos, texto principal e rótulos de botões, sua palette (cores rgb realmente usadas, classificadas por quanto da página cobrem, divididas em background, text, button, link) e suas fonts. Os logos e images de nível superior listam os candidatos. Uma lista button vazia ou uma fonte system-ui significa que o site não as expôs: pegue o tom das capturas de tela e escolha fontes a olho.
  • screens/: uma captura de tela de cada página
  • logos/: cada candidato a logotipo (SVG do cabeçalho ou imagem, ícones de aplicativo, imagem social)
  • images/: as maiores imagens de conteúdo (produtos, pratos, projetos, capturas de tela de aplicativos, pessoas)

brief.json → logos e images listam o tamanho em pixels de cada arquivo (px) e uma note quando é muito pequeno para o cartão ou um banner largo.

Se ele ler apenas uma página, o site provavelmente constrói seus links com scripts ou bloqueia visitas automatizadas. Execute-o novamente com uma página de produto como URL inicial, ou pergunte ao usuário.

Em seguida, olhe realmente, como um designer faria antes de começar:

  • Capturas de tela: abra as capturas de tela da página inicial e de uma ou duas páginas de produto. Tenha a sensação (escuro ou claro, lúdico ou sério, fotográfico ou UI plana) e qual cor é o tom da marca. O fundo do botão mais usado geralmente é o tom.
  • Logotipos: abra os candidatos a logotipo.
    • Um SVG do cabeçalho geralmente é a melhor fonte. Um apple-touch-icon pode ser uma marca quadrada limpa, mas verifique seu px: muitos sites servem ícones de 32×32, que ficam borrados no cartão. Qualquer coisa anotada como "muito pequeno para o cartão" está fora.
    • Verifique o que você tem. Uma marca quadrada vai em logo. Uma marca nominativa larga vai em wordmark e aparece no cartão da marca no lugar do nome digitado.
    • Sem um logotipo quadrado, o cartão se adapta. Com uma marca nominativa, ele descarta a coluna esquerda, para que o nome não seja mostrado duas vezes. Sem nenhum, ele desenha a primeira letra da marca na cor de destaque.
    • Não use um favicon abaixo de 64 px ou um recorte borrado: peça um arquivo ao usuário.
    • Logotipos feitos para um cabeçalho branco podem desaparecer em um cartão escuro. Se isso acontecer, use um cartão claro, peça uma versão clara ou edite o preenchimento de um SVG.
  • Imagens: abra as imagens candidatas para uma cena de vitrine. Pule fotos com aparência de banco de imagens, rostos de pessoas (pergunte primeiro) e qualquer coisa com texto pequeno que não será legível em 168×126.
    • O quadro corta para preencher (cerca de 4:3). Banners heróis largos geralmente têm texto e botões incorporados, e cortá-los deixa lascas de letras. Corte você mesmo para o assunto primeiro:
      ffmpeg -i resumo-do-site/images/00.png -vf "crop=900:675:500:110" crop-1.png
      
      Aqui crop=w:h:x:y seleciona uma caixa 4:3 ao redor do produto. Então abra o resultado para verificar.
  • Texto: leia o texto principal e os cabeçalhos. Entenda o que o negócio realmente faz por um cliente, nas palavras deles, e quaisquer números reais que ele declare publicamente (clientes atendidos, pedidos entregues, anos de operação).

Se o site bloquear o script (paywall, proteção contra bots) ou for superficial, peça ao usuário o logotipo, as cores e uma frase sobre o que o negócio faz.

3. Escolher a cena e escrever a história, depois obter aprovação

brand.json → story.type escolhe uma das três cenas. Escolha aquela que mostra este negócio fazendo seu trabalho mais claramente:

CenaAdequado paraCampos da história
chatsoftware, agentes de IA, aplicativos, serviços que respondem ou corrigem algoquestion (≤ 32 caracteres), três steps de { text ≤ 34, status: "ok" | "warn" }, result (≤ 28), details (2–3 linhas ≤ 40)
counterum número público real: dinheiro manipulado, pedidos enviados, clientes atendidos, anos de operaçãolabel (≤ 40), value (número), prefix/suffix (ex.: "R$", "+", " pedidos"), decimals, result (≤ 28), details
showcaselojas, comida, viagens, estúdios, portfólios, produtos físicos: qualquer coisa melhor mostrada do que contadaitems: 2–3 de { image: "resumo-do-site/images/03.jpg", title ≤ 22, text ≤ 36 }. Fotos são a parte mais pesada de um GIF: em testes, 2 fotos chegaram a cerca de 790 KB, 3 a cerca de 940 KB e 4 ultrapassaram 1 MB.

O número de um contador deve ser um que o negócio já declare publicamente (em seu próprio site), com a aprovação do usuário. Nunca invente um. Uma vitrine usa as próprias imagens do negócio de seu site, não imagens de banco.

Para adicionar uma cena diferente (um antes/depois, uma rota de marcador de mapa, uma barra de progresso), adicione uma entrada a SCENES em uma cópia de card.html e renderize com --card seu-card.html. Mantenha as regras em "Por que foi construído assim".

Escreva brand.json (copie assets/brand.example.json; caminhos de imagem são relativos a brand.json):

  • Nome, domínio, URLs: name, domain, siteUrl e gifUrl, o endereço absoluto onde o GIF viverá (por exemplo https://site-deles.com/email/signature.gif).
  • Texto: tagline, cerca de cinco palavras dizendo o que o negócio faz. Opcionalmente email, o email placeholder mostrado na página da equipe.
  • Imagens: logo (uma marca quadrada, opcional) e wordmark (opcional).
  • Fontes: nomes de famílias do Google Fonts. brief.json lista as fontes do próprio site.
    • Se essas estiverem no Google Fonts, use-as.
    • Se forem proprietárias ou auto-hospedadas, escolha a fonte do Google mais próxima por sensação: um sem arredondado para um sem arredondado, uma serif para uma serif.
    • Deixe fonts de fora para usar fontes do sistema.
  • Cores: colors, construídas a partir da paleta do site:
    • bg: o fundo do cartão. Um tom escuro da marca funciona bem em caixas de entrada claras e não ofusca nas escuras. Um cartão claro também funciona, se o site for claro.
    • card: uma cor de painel ligeiramente diferente
    • line: bordas
    • text, muted e subtle: texto, do mais forte ao mais fraco. Eles precisam de contraste claro em bg.
    • accent: a cor da marca
    • good e bad: um verde e um vermelho
    • link: um tom escuro o suficiente para ser legível em uma caixa de entrada branca

Defina story.type para a cena escolhida; o padrão é chat.

Mostre ao usuário o plano antes de renderizar e aguarde a aprovação dele. Inclua a cena, as linhas da história (ou imagens escolhidas com legendas) e qual logotipo você usará.

4. Renderizar e olhar

node <pasta da habilidade>/scripts/render.mjs brand.json signature.gif

Ele imprime o tamanho e linhas PASS, escreve signature-last.png (o final do loop, que deve corresponder ao primeiro quadro), falha se o texto sair da borda, o arquivo tiver mais de 1 MB ou o loop não terminar no primeiro quadro, e escreve signature-first.png, o quadro que o Outlook antigo mostra. Abra essa imagem e dois ou três quadros do meio do loop e verifique:

  • nada está cortado na borda direita (texto longo é a causa usual)
  • o logotipo está nítido
  • as cores são legíveis
  • o primeiro quadro é um cartão finalizado

Para extrair um quadro em, digamos, 5 s, execute ffmpeg -ss 5 -i signature.gif -frames:v 1 frame5.png. Corrija e renderize novamente até que passe e pareça correto. Se estiver acima de 1 MB, remova primeiro o movimento de área grande. Reduzir --fps 12 é um último recurso.

Mostre ao usuário o primeiro quadro e um quadro do meio do loop (ou o próprio GIF) antes de prosseguir.

5. Construir a página da equipe

node <pasta da habilidade>/scripts/build-page.mjs brand.json email-signature.html

Para visualizá-la antes da implantação, execute npx serve . na pasta de trabalho e abra http://localhost:3000/email-signature?preview=signature.gif. Deixe de fora .html: serve redireciona endereços .html e descarta a parte ?preview, e a página então tenta o GIF ainda não ao vivo. O parâmetro preview apenas altera o que a página mostra; a assinatura copiada ainda aponta para gifUrl. Teste com um nome longo e com caracteres como < e &, que devem ser mostrados como digitados.

6. Implantar

Leia references/deploy.md. Ele cobre onde os dois arquivos vão para stacks comuns (hospedagens estáticas, Next.js, Astro, WordPress, Webflow e outros), onde hospedar o GIF quando o usuário não puder colocar arquivos no site, a linha robots.txt e o que verificar uma vez que esteja ao vivo. Siga a maneira normal do site de enviar alterações: um branch e pull request se for um repositório git. Não faça push ou implante sem a autorização do usuário.

7. Entregar

Diga ao usuário:

  • Links: o endereço da página para compartilhar com a equipe e o endereço do GIF.
  • Verificado: o que você mesmo verificou, como as verificações de renderização, os quadros que você olhou e a visualização da página.
  • Ainda para verificar após a implantação: colar no Gmail, Outlook e Apple Mail, a partir da lista em deploy.md. Nada sobre aplicativos de email reais pode ser verificado antes do GIF estar ao vivo, então diga isso claramente em vez de insinuar que funciona.
  • Atualizar depois: edite brand.json, renderize novamente e substitua o GIF no mesmo endereço. A assinatura de todos é atualizada por conta própria, embora os caches de imagem do aplicativo de email possam levar um dia ou mais.

Habilidades Relacionadas