Communitygithub.com

brainzcode/premium-landing

Versendet Link-Vorschaubilder und Favicons, die tatsächlich funktionieren – Open Graph- und Twitter-Card-Tags, ein korrekt zugeschnittenes 1200x630-Share-Bild und ein vollständiges Favicon-Set (SVG, ICO, Apple-Touch, maskierbare Manifest-Icons).

Was ist premium-landing?

Dieses Skill behandelt die technischen Fallstricke, die beim Einrichten von Social-Sharing-Vorschaubildern (Open Graph, Twitter Cards) und Favicons auftreten. Es erklärt, warum relative URLs in `og:image` und `og:url` grundsätzlich zu leeren Karten führen, und bietet eine vollständige und korrekte HTML-Tag-Struktur. Darüber hinaus werden Details zur Erstellung eines Share-Bildes im Format 1200x630 behandelt, einschließlich der korrekten Viewport-Berechnung und Framing-Techniken, um Beschneidungsfehler zu vermeiden. Das Skill enthält ein Python-Skript zur automatischen Generierung aller benötigten Favicon-Formate und des Share-Bildes, wobei typische Fehler wie die Verwendung von `<text>` in SVG-Favicons (Schriftartenabhängigkeit) und transparente Hintergründe thematisiert werden. Es ist für Entwickler gedacht, die Claude Code, Cursor, Codex oder andere KI-gestützte Entwicklungswerkzeuge verwenden und sicherstellen möchten, dass ihre Websites korrekte Vorschaubilder und Icons auf allen Plattformen (Facebook, X, LinkedIn, iOS, Android) anzeigen.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Social Sharing und Favicons

Das Einzige, was zählt

og:image und og:url müssen absolute URLs auf einem öffentlich erreichbaren Host sein.

Der Crawler ruft sie von seinen eigenen Servern ab. Er hat keinen Seitenkontext, keine Cookies, keinen Referer und keine Ahnung, worauf sich ein relativer Pfad bezieht. Ein Pfad wie /assets/og.jpg oder assets/og.jpg löst sich in nichts auf, und die Karte bleibt leer.

<!-- Tot: Rendert eine leere Karte überall -->
<meta property="og:image" content="assets/images/og-image.jpg">

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

Dies ist der häufigste Grund, warum eine Vorschau nicht funktioniert. Bevor Sie etwas anderes debuggen, bestätigen Sie, dass die URL absolut ist und in einem privaten Fenster lädt.

Die Kehrseite: Vorschauen können auf localhost oder file:// nicht funktionieren. Nichts, was Sie lokal tun, wird eine echte Vorschau erzeugen. Stellen Sie zuerst bereit, dann validieren Sie.

Der Tag-Satz

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

<meta property="og:type"        content="website">
<meta property="og:site_name"   content="Brand">
<meta property="og:locale"      content="en_US">
<meta property="og:url"         content="https://example.com/">
<meta property="og:title"       content="Brand – was es ist">
<meta property="og:description" content="Ein Satz. Etwa 110 Zeichen.">
<meta property="og:image"       content="https://example.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="Was ist auf dem Bild.">

<meta name="twitter:card"        content="summary_large_image">
<meta name="twitter:title"       content="Brand – was es ist">
<meta name="twitter:description" content="Ein Satz. Etwa 110 Zeichen.">
<meta name="twitter:image"       content="https://example.com/og-image.jpg">
<meta name="twitter:image:alt"   content="Was ist auf dem Bild.">

Drei Details, die leicht falsch gemacht werden:

og: verwendet property=, twitter: verwendet name=. Eine Verwechslung wird stillschweigend ignoriert, sodass die Tags im Quelltext vorhanden erscheinen und nichts bewirken. Einige Parser tolerieren name= bei og:, aber verlassen Sie sich nicht darauf.

twitter:card muss summary_large_image sein. Der Standardwert ist eine kleine quadratische Karte mit dem Bild als Miniaturansicht neben dem Text, was ein 1200x630-Bild verschwendet.

Die Angabe von og:image:width und og:image:height bewirkt, dass die Karte sofort gerendert wird. Ohne sie muss die Plattform das Bild herunterladen, bevor sie das Seitenverhältnis kennt, sodass die erste Person, die den Link teilt, oft eine reine Textkarte sieht. Sie müssen mit der tatsächlichen Datei übereinstimmen. Messen Sie es, gehen Sie nicht davon aus.

Kopienlänge: Titel werden bei etwa 60 Zeichen abgeschnitten, Beschreibungen je nach Plattform zwischen 110 und 200 Zeichen. Laden Sie die Bedeutung vor.

Das Share-Bild

1200x630 (1,905:1). JPEG, es sei denn, das Design benötigt Alpha, was es nicht tut, da jede Plattform auf Weiß komponiert. Halten Sie es unter etwa 1 MB; die harten Grenzen sind 8 MB (Facebook) und 5 MB (X), aber große Dateien führen beim Scraping zu Zeitüberschreitungen.

Rendern Sie es im Zielverhältnis, beschneiden Sie keinen Screenshot

Das Aufnehmen eines beliebigen Screenshots und das Zuschneiden auf 1,905:1 verwirft die Komposition, die der Designer gewählt hat. Rendern Sie die Quelle stattdessen im Verhältnis:

# 1440x756 sind exakt 1,905:1, sodass es auf 1200x630 skaliert wird, ohne Beschnitt
chrome --headless --disable-gpu --hide-scrollbars --virtual-time-budget=8000 \
  --window-size=1440,756 --screenshot=og-src.png "file://$PWD/index.html"

Die Kurz-Viewport-Falle

Wenn die Seite einen vollständigen Hero-Bereich hat (100vh / 100svh), ergibt das Rendern direkt bei 1,905:1 einen Viewport, der viel kürzer ist als ein echter Desktop-Bildschirm. Jegliche object-fit: cover-Medien beschneiden viel stärker als in der realen Nutzung, und Elemente, die sich normalerweise ausweichen, kollidieren – typischerweise ein Header-Logo, das auf dem Kopf des Motivs landet.

Rendern Sie in einem höheren Viewport, damit die Medien so beschnitten werden wie in der realen Nutzung, und schneiden Sie dann das 1,905:1-Fenster daraus aus:

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     # oben verankert

Vergleichen Sie einen oben verankerten Beschnitt mit einem zentrierten, bevor Sie sich entscheiden. Oben verankert behält in der Regel die Markenelemente (Utility-Leiste, Navigation, Wortmarke); zentriert behält in der Regel das Motiv und den Call-to-Action. Sie können nicht beides haben, da ein vollständiger Hero-Bereich höher ist, als 1,905:1 erlaubt.

Rahmung

Karten werden im Feed etwa 500 Pixel breit gerendert, und jede Plattform beschneidet anders (LinkedIn und Slack sind enger als Facebook). Halten Sie alles, was überleben muss, innerhalb der zentralen 80%, und setzen Sie jeglichen Text groß genug, um ihn bei halber Größe lesen zu können. Feine UI-Details verschwinden; eine große Wortmarke und ein starkes Bild tun das nicht.

Favicons

Die Schriftartenfalle

Setzen Sie kein <text> in ein SVG-Favicon.

<!-- Zerbricht: Rendert in der Fallback-Schriftart, die der Betrachter zufällig hat -->
<svg ...><text x="50%" y="50%" font-family="Geist">G</text></svg>

Das SVG wird auf dem Rechner des Betrachters gerendert, auf dem Ihre Webschriftart nicht existiert. Extrahieren Sie die Glyphe als Pfad, sodass sie schriftartenunabhängig und auflösungsunabhängig ist. Siehe das Skript unten.

Die Transparenzfalle

Eine dunkle Glyphe auf transparentem Hintergrund verschwindet vor dunkler Browser-Chrome, und eine helle verschwindet auf heller. Zeichnen Sie das Symbol auf einer gefüllten Kachel. Es verleiht der Marke auch eine konsistente Silhouette über Tab-Leisten, Lesezeichen und Startbildschirme hinweg.

Der Dateisatz

DateiGrößeWarum
/favicon.ico16, 32, 48Browser fordern diesen Pfad implizit an, auch wenn Sie andere deklarieren; halten Sie ihn im Web-Root
favicon.svgskalierbarWas moderne Browser bevorzugen, und es bleibt auf jedem Display scharf
apple-touch-icon.png180iOS-Startbildschirm
icon-192.png192Manifest
icon-512.png512Manifest, Splash-Screens
icon-maskable-512.png512Android adaptive Masken
<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">

Die maskierbare Sicherheitszone

Android beschneidet Symbole in beliebige Formen (Kreis, abgerundetes Quadrat, Tropfen). Ein maskable-Symbol muss alles Bedeutungsvolle innerhalb des zentralen 80%-Kreises behalten, was bedeutet, dass etwa 40% der Kachelkante wegwerfbarer Abstand ist. Wenn Sie das normale Symbol wiederverwenden, werden seine Kanten abgeschnitten.

In der Praxis: Wenn die Glyphe 60% der Kachel im Standardsymbol bedeckt, reduzieren Sie sie auf etwa 40% für das maskierbare. Liefern Sie beide, mit "purpose": "any" und "purpose": "maskable" als separate Einträge. Setzen Sie niemals beide Zwecke in eine Datei.

Web-Manifest

{
  "name": "Brand",
  "short_name": "Brand",
  "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 färbt die mobile Browser-Chrome ein, sollte also mit dem übereinstimmen, was sich ganz oben auf der Seite befindet, nicht mit der Hauptfarbe der Marke. Wenn die Seite mit einer schwarzen Utility-Leiste beginnt, verwenden Sie dieses Schwarz. Eine Abweichung wirkt wie ein Rendering-Fehler. Spiegeln Sie es in <meta name="theme-color"> wider.

background_color ist der Splash-Screen hinter dem Symbol vor dem ersten Paint, sollte also mit dem Seitenhintergrund übereinstimmen.

Generierungsskript

Benötigt pillow und fonttools. Erzeugt den gesamten Symbolsatz sowie das Share-Bild.

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   = "brand.ttf"      # die echte Markenschriftart, in der Gewichtung der Wortmarke
CHAR   = "G"
INK    = "#0a0a0a"        # Kachel
PAPER  = "#f2f1ed"        # Glyphe
COVER  = 0.60             # Glyphenhöhe als Anteil der Kachel
OUT    = "assets/icons"
os.makedirs(OUT, exist_ok=True)

# ── SVG: Glyphe als echter Pfad, sodass sie nicht von den Schriftarten des Betrachters abhängt ──
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 wird gespiegelt: Schriftarten sind y-nach oben, SVG ist y-nach unten

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>')

# ── Raster-Kacheln ────────────────────────────────────────────────────────────
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)  # 40% Sicherheitszone
tile(256).save("favicon.ico", sizes=[(16, 16), (32, 32), (48, 48)])

# ── Share-Bild: Beschneiden eines größeren Rendert auf das Verhältnis, dann herunterskalieren ──────────────
src = Image.open("og-src.png").convert("RGB")          # z.B. 1440x1000
src.crop((0, 0, 1440, 756)).resize((1200, 630), Image.LANCZOS).save(
    "assets/images/og-image.jpg", quality=88, optimize=True, progressive=True)

Keine Markenschriftart verfügbar? Jede geometrische Groteske funktioniert für ein Monogramm. Das Rastern eines vorhandenen Logo-PNGs auf die Kachel ist ebenfalls in Ordnung; zentrieren Sie es einfach innerhalb desselben COVER-Anteils und halten Sie die maskierbare Variante kleiner.

Vor dem Bereitstellen überprüfen

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} ist nicht absolut: {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"]), "deklarierte Größe ist falsch"
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"fehlendes Symbol {i['src']}"
print("ok")

Checkliste:

  • og:image und og:url absolut, auf dem echten Host, laden in einem privaten Fenster
  • deklarierte og:image:width / height stimmen mit der tatsächlichen Datei überein
  • twitter:card ist summary_large_image
  • og:-Tags verwenden property=, twitter:-Tags verwenden name=
  • jeder Platzhalter-Domain ersetzt (danach suchen; es gibt normalerweise vier)
  • favicon.ico im Web-Root, nicht nur in einem Assets-Ordner
  • SVG-Favicon enthält einen <path>, kein <text>
  • Symbolkachel ist gefüllt, sodass sie sowohl in dunkler als auch heller Browser-Chrome überlebt
  • maskierbares Symbol auf die zentralen 80% aufgepolstert
  • theme_color stimmt mit der Oberkante der Seite überein

Caching

Jede Plattform cacht aggressiv und wird nach einer Korrektur weiterhin die alte Karte ausliefern. Erneutes Scraping:

LinkedIn cacht am stärksten und ignoriert Änderungen effektiv für etwa 7 Tage, es sei denn, Sie führen den Inspektor aus. Wenn eine URL bereits weit verbreitet mit einer defekten Karte geteilt wurde, erzwingt das Hinzufügen eines Query-Strings (?v=2) ein erneutes Scraping.

Favicons werden auch im Browser hart gecacht. Testen Sie in einem privaten Fenster; ein normaler Neuladevorgang liefert normalerweise das alte Symbol weiter.

Platzhalter-Domains

Wenn die echte Domain noch nicht bekannt ist, verwenden Sie eine Subdomain von example.com (https://brand.example.com). RFC 2606 reserviert sie, sodass sie unmissverständlich ein Platzhalter ist und niemals versehentlich auf eine Domain zeigen kann, die jemand anderes besitzt. Hinterlassen Sie keine plausible, aber nicht besessene Domain in ausgelieferten Metadaten.

Setzen Sie die Ersetzungsanweisung in einen Kommentar direkt über dem Block und in die Projekt-README, und geben Sie an, wie viele Vorkommen es gibt. Normalerweise sind es vier: 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.

Verwandte Skills