Animierte E-Mail-Signatur
Du erstellst zwei Dinge für die Marke des Benutzers und platzierst sie auf dessen Website:
- Ein Loop-GIF (1200×340, angezeigt mit 480×136, ca. 11 s, unter 1 MB). Es beginnt mit der Markenkarte (Logo, Name, Slogan, Domain), zeigt das Produkt bei einer echten Aufgabe und kehrt zur Markenkarte zurück.
- Eine Team-Seite, auf der jede Person ihren Namen, ihre Position und E-Mail eingibt, die Signatur in einem hellen und einem dunklen Posteingang sieht und sie kopiert. Name und Position bleiben als Live-Text erhalten, sodass ein GIF für das gesamte Team ausreicht. Die Seite weist Suchmaschinen und KI-Crawler an, fernzubleiben.
Das Skill-Verzeichnis enthält:
scripts/inspect-site.mjs: Liest die Website aus (Seiten, Farben, Schriftarten, Logos, Bilder, Screenshots)assets/card.html: Die Animation mit drei Szenen (Chat, Counter, Showcase), befüllt überbrand.jsonassets/signature-page.html: Die Team-Seiteassets/brand.example.json: Ein Beispiel-Brand zum Kopierenscripts/render.mjs: Karte → GIF, inklusive Größen- und Loop-Prüfungenscripts/build-page.mjs:brand.json→ die Team-Seitereferences/deploy.md: Beides auf der Website platzieren; lies es in Schritt 6
Warum es so gebaut ist
Wenn du diese Punkte kennst, triffst du gute Entscheidungen, falls eine Marke nicht in die Vorlage passt:
- E-Mails können keinen Code ausführen. Gmail, Outlook und Apple Mail entfernen Skripte, Videos und CSS-Animationen aus Signaturen. Die einzige Bewegung, die überall funktioniert, ist ein animiertes GIF.
- Älteres Desktop-Outlook zeigt nur das erste Bild. Daher muss Frame 0 die fertige Markenkarte sein, niemals leer oder halb gezeichnet. Der Loop endet exakt auf dieser Karte, sodass der Neustart keinen sichtbaren Sprung hat.
render.mjsprüft beides. - Größe ist entscheidend. Große Signaturen werden abgeschnitten oder laden langsam. Halte das GIF unter 1 MB. Ein GIF speichert nur die Pixel, die sich zwischen den Frames ändern. Wenn sich in jedem Frame eine große Fläche ändert, bläht sich die Datei auf. In einem echten Build hat ein sanft pulsierender Glanz hinter dem Logo das GIF von 434 KB auf 1,26 MB vergrößert. Bevorzuge Bewegung in kleinen Bereichen: tippender Text, Symbole, kurze Überblendungen.
render.mjsschlägt fehl, wenn die Datei über 1 MB liegt. - Gezeichnet im 2×-Maßstab, angezeigt in fester Größe. Das hält es auf Retina-Bildschirmen scharf. Das Signatur-HTML setzt
width="480" height="136", sodass die Mail-App es niemals mit der 1200 px Dateibreite anzeigt. - Die kopierte Signatur muss auf die absolute https-Adresse des Live-GIFs zeigen. Eine Mail-App kann keine lokale Datei oder einen relativen Pfad laden. Die Seite kopiert immer
gifUrl, auch wenn sie eine lokale Datei in der Vorschau zeigt. - Der Name hat keine eigene Farbe. Er übernimmt die Textfarbe des Posteingangs, sodass er im hellen und dunklen Modus lesbar ist. Die zweite Zeile und der E-Mail-Link verwenden mittlere Töne, die auf beiden lesbar sind.
- Die Geschichte zeigt nur, was das Produkt wirklich tut. Eine Signatur erreicht Kunden und Investoren. Eine erfundene Funktion oder Zahl darin ist eine falsche Behauptung in jeder E-Mail, die das Team sendet. Hol dir die Geschichte von der eigenen Website oder Dokumentation des Produkts und hole die Zustimmung des Benutzers ein, bevor du renderst.
Schritte
1. Arbeitsverzeichnis einrichten
Verwende ein Verzeichnis außerhalb des Website-Repos, damit Werkzeuge nicht auf der Seite landen:
mkdir email-signature-work && cd email-signature-work
npm init -y
npm i playwright
npx playwright install chromium
Überprüfe ffmpeg mit ffmpeg -version. Zur Installation: auf macOS brew install ffmpeg, auf Windows winget install Gyan.FFmpeg, auf Linux sudo apt install ffmpeg.
Führe alle folgenden Befehle aus diesem Verzeichnis aus. brand.json, der Site-Brief, etwaig beschnittene Bilder und die Ausgaben leben alle hier, neben node_modules.
2. Die Website auslesen
node <skill-verzeichnis>/scripts/inspect-site.mjs https://deren-seite.de site-brief --pages 6
Es öffnet die Startseite und bis zu 6 weitere Seiten (zunächst Produkte, Funktionen, Über uns, Preise) und schreibt site-brief/:
brief.json:pages[]enthält für jede Seite den Titel, die Beschreibung, Überschriften, Haupttext und Button-Beschriftungen, ihrepalette(tatsächlich verwendete RGB-Farben, sortiert nach Flächenabdeckung, aufgeteilt inbackground,text,button,link) und ihrefonts. Die oberstenlogosundimageslisten die Kandidaten. Eine leerebutton-Liste oder einesystem-ui-Schrift bedeutet, dass die Seite sie nicht preisgegeben hat: Nimm stattdessen die Akzentfarbe aus den Screenshots und wähle Schriftarten nach Augenmaß.screens/: Ein Screenshot jeder Seitelogos/: Jeder Logo-Kandidat (Header-SVG oder -Bild, App-Icons, Social-Image)images/: Die größten Inhaltsbilder (Produkte, Gerichte, Projekte, App-Screenshots, Personen)
brief.json → logos und images listen die Pixelgröße (px) jeder Datei und einen note, wenn sie für die Karte oder ein breites Banner zu klein ist.
Wenn nur eine Seite gelesen wird, erstellt die Website ihre Links wahrscheinlich mit Skripten oder blockiert automatisierte Besuche. Führe es erneut mit einer Produktseite als Start-URL aus oder frage den Benutzer.
Sieh dir dann genau an, wie ein Designer vor dem Start:
- Screenshots: Öffne die Screenshots der Startseite und ein oder zwei Produktseiten. Gewinne einen Eindruck (dunkel oder hell, verspielt oder ernst, fotografisch oder flaches UI) und welche Farbe die Markenakzentfarbe ist. Der am häufigsten verwendete Button-Hintergrund ist normalerweise der Akzent.
- Logos: Öffne die Logo-Kandidaten.
- Ein Header-SVG ist normalerweise die beste Quelle. Ein
apple-touch-iconkann ein sauberes quadratisches Markenzeichen sein, aber überprüfe seinepx: Viele Seiten liefern 32×32-Icons, die auf der Karte verschwimmen. Alles, was mit „zu klein für die Karte“ vermerkt ist, ist raus. - Prüfe, was du hast. Ein quadratisches Markenzeichen kommt in
logo. Eine breite Wortmarke kommt inwordmarkund wird auf der Markenkarte anstelle des getippten Namens angezeigt. - Ohne quadratisches Logo passt sich die Karte an. Mit einer Wortmarke wird die linke Spalte weggelassen, sodass der Name nicht doppelt angezeigt wird. Mit keinem von beiden wird der erste Buchstabe der Marke in der Akzentfarbe gezeichnet.
- Verwende kein Favicon unter 64 px oder einen unscharfen Ausschnitt: Frage stattdessen den Benutzer nach einer Datei.
- Logos, die für einen weißen Header erstellt wurden, können auf einer dunklen Karte verschwinden. Verwende in diesem Fall eine helle Karte, frage nach einer hellen Version oder bearbeite die Füllung eines SVGs.
- Ein Header-SVG ist normalerweise die beste Quelle. Ein
- Bilder: Öffne die Kandidatenbilder für eine Showcase-Szene. Überspringe stockähnliche Fotos, Gesichter von Personen (frage zuerst) und alles mit kleinem Text, der bei 168×126 nicht lesbar ist.
- Der Frame wird auf etwa 4:3 zugeschnitten. Breite Hero-Banner haben meist eingebackenen Text und Buttons, und das Zuschneiden hinterlässt Buchstabenschnipsel. Schneide selbst zuerst auf das Motiv zu:
Hier wähltffmpeg -i site-brief/images/00.png -vf "crop=900:675:500:110" crop-1.pngcrop=w:h:x:yein 4:3-Box um das Produkt. Öffne dann das Ergebnis, um es zu überprüfen.
- Der Frame wird auf etwa 4:3 zugeschnitten. Breite Hero-Banner haben meist eingebackenen Text und Buttons, und das Zuschneiden hinterlässt Buchstabenschnipsel. Schneide selbst zuerst auf das Motiv zu:
- Text: Lies den Haupttext und die Überschriften. Erfahre, was das Unternehmen wirklich für einen Kunden tut, in seinen eigenen Worten, und alle echten Zahlen, die es öffentlich nennt (bediente Kunden, versendete Bestellungen, Betriebsjahre).
Wenn die Website das Skript blockiert (Login-Wand, Bot-Schutz) oder dünn ist, frage den Benutzer nach dem Logo, den Farben und einem Satz, was das Unternehmen tut.
3. Szene auswählen und Geschichte schreiben, dann Genehmigung einholen
brand.json → story.type wählt eine von drei Szenen. Wähle diejenige, die dieses Unternehmen bei seiner Arbeit am deutlichsten zeigt:
| Szene | Passend für | Story-Felder |
|---|---|---|
chat | Software, KI-Agenten, Apps, Dienste, die etwas beantworten oder reparieren | question (≤ 32 Zeichen), drei steps von { text ≤ 34, status: "ok" | "warn" }, result (≤ 28), details (2–3 Zeilen ≤ 40) |
counter | Eine echte öffentliche Zahl: abgewickeltes Geld, versendete Bestellungen, bediente Kunden, Betriebsjahre | label (≤ 40), value (Zahl), prefix/suffix (z. B. „₹“, „+", „ Bestellungen"), decimals, result (≤ 28), details |
showcase | Geschäfte, Essen, Reisen, Studios, Portfolios, physische Produkte: alles, was besser gezeigt als erzählt wird | items: 2–3 von { image: "site-brief/images/03.jpg", title ≤ 22, text ≤ 36 }. Fotos sind der schwerste Teil eines GIFs: In Tests kamen 2 Fotos auf ca. 790 KB, 3 auf ca. 940 KB und 4 überschritten 1 MB. |
Eine Counter-Zahl muss eine sein, die das Unternehmen bereits öffentlich (auf der eigenen Website) nennt, mit OK des Benutzers. Erfinde niemals eine. Ein Showcase verwendet die eigenen Bilder des Unternehmens von seiner Website, keine Stock-Bilder.
Um eine andere Szene hinzuzufügen (ein Vorher/Nachher, eine Karten-Pin-Route, einen Fortschrittsbalken), füge einen Eintrag zu SCENES in einer Kopie von card.html hinzu und rendere mit --card deine-card.html. Behalte die Regeln aus „Warum es so gebaut ist“ bei.
Schreibe brand.json (kopiere assets/brand.example.json; Bildpfade sind relativ zu brand.json):
- Name, Domain, URLs:
name,domain,siteUrlundgifUrl, die absolute Adresse, unter der das GIF leben wird (z. B.https://deren-seite.de/email/signature.gif). - Text:
tagline, etwa fünf Wörter, die beschreiben, was das Unternehmen tut. Optionalemail, die Platzhalter-E-Mail, die auf der Team-Seite angezeigt wird. - Bilder:
logo(ein quadratisches Markenzeichen, optional) undwordmark(optional). - Schriftarten: Google-Fonts-Familiennamen.
brief.jsonlistet die eigenen Schriftarten der Website.- Wenn diese auf Google Fonts verfügbar sind, verwende sie.
- Wenn sie proprietär oder selbst gehostet sind, wähle die nächstgelegene Google-Schriftart nach Gefühl: eine abgerundete Sans für eine abgerundete Sans, eine Serife für eine Serife.
- Lasse
fontsweg, um Systemschriften zu verwenden.
- Farben:
colors, aufgebaut aus der Palette der Website:bg: Der Kartenhintergrund. Ein dunkler Farbton der Marke liest sich gut in hellen Posteingängen und blendet nicht in dunklen. Eine helle Karte funktioniert auch, wenn die Seite hell ist.card: Eine leicht andere Panel-Farbeline: Rändertext,mutedundsubtle: Text, von stärkstem bis schwächstem. Sie benötigen klaren Kontrast aufbg.accent: Die Markenfarbegoodundbad: Ein Grün und ein Rotlink: Ein Akzent, der dunkel genug ist, um auf einem weißen Posteingang lesbar zu sein
Setze story.type auf die von dir gewählte Szene; standardmäßig ist es chat.
Zeige dem Benutzer den Plan vor dem Rendern und warte auf sein OK. Füge die Szene, die Story-Zeilen (oder ausgewählte Bilder mit Bildunterschriften) und welches Logo du verwenden wirst, hinzu.
4. Rendern und ansehen
node <skill-verzeichnis>/scripts/render.mjs brand.json signature.gif
Es gibt die Größe und PASS-Zeilen aus, schreibt signature-last.png (das Ende des Loops, das mit dem ersten Frame übereinstimmen muss), schlägt fehl, wenn Text über den Rand läuft, die Datei über 1 MB ist oder der Loop nicht auf dem ersten Frame endet, und schreibt signature-first.png, den Frame, den älteres Outlook anzeigt. Öffne dieses Bild und zwei oder drei Frames aus der Mitte des Loops und überprüfe:
- nichts ist am rechten Rand abgeschnitten (langer Text ist die übliche Ursache)
- das Logo ist scharf
- die Farben sind lesbar
- der erste Frame ist eine fertige Karte
Um einen Frame etwa bei 5 s zu extrahieren, führe ffmpeg -ss 5 -i signature.gif -frames:v 1 frame5.png aus. Korrigiere und rendere neu, bis es besteht und richtig aussieht. Wenn es über 1 MB liegt, entferne zuerst die großflächige Bewegung. --fps 12 zu senken ist der letzte Ausweg.
Zeige dem Benutzer den ersten Frame und einen Frame aus der Mitte des Loops (oder das GIF selbst), bevor du fortfährst.
5. Die Team-Seite erstellen
node <skill-verzeichnis>/scripts/build-page.mjs brand.json email-signature.html
Um sie vor dem Deployment in der Vorschau anzuzeigen, führe npx serve . im Arbeitsverzeichnis aus und öffne http://localhost:3000/email-signature?preview=signature.gif. Lasse .html weg: serve leitet .html-Adressen um und verwirft den ?preview-Teil, und die Seite versucht dann das noch nicht live befindliche GIF. Der preview-Parameter ändert nur, was die Seite anzeigt; die kopierte Signatur zeigt weiterhin auf gifUrl. Teste es mit einem langen Namen und mit Zeichen wie < und &, die genau so angezeigt werden müssen, wie sie getippt wurden.
6. Deployment
Lies references/deploy.md. Es behandelt, wo die beiden Dateien für gängige Stacks hingehen (statische Hosts, Next.js, Astro, WordPress, Webflow und andere), wo das GIF gehostet wird, wenn der Benutzer keine Dateien auf seiner Website ablegen kann, die robots.txt-Zeile und was überprüft werden muss, sobald es live ist. Folge der üblichen Art der Website, Änderungen auszuliefern: ein Branch und Pull-Request, wenn es ein Git-Repo ist. Pushe oder deploye nicht ohne die Zustimmung des Benutzers.
7. Übergabe
Sage dem Benutzer:
- Links: Die Seitenadresse zum Teilen mit dem Team und die GIF-Adresse.
- Verifiziert: Was du selbst überprüft hast, z. B. die Render-Prüfungen, die von dir angesehenen Frames und die Seitenvorschau.
- Noch zu überprüfen nach Deployment: Einfügen in Gmail, Outlook und Apple Mail, gemäß der Liste in
deploy.md. Nichts über echte Mail-Apps kann vor dem Live-Schalten des GIFs überprüft werden. Sage das deutlich, anstatt zu implizieren, dass es funktioniert. - Später aktualisieren: Bearbeite
brand.json, rendere neu und ersetze das GIF unter derselben Adresse. Die Signatur jedes Teammitglieds aktualisiert sich von selbst, obwohl Bildercaches von Mail-Apps einen Tag oder länger dauern können.