CommunityBildgithub.com

og-images

Erstellt Social-Media-Vorschaubilder aus der echten App-Oberfläche: Open Graph-, X-Karten, Product Hunt-Galerien und X-Header – mit großen lesbaren Titeln, App-Icon und echten Screenshots.

Was ist og-images?

Dieses Skill erstellt automatisch Launch-Bilder für eine App, basierend auf deren echter Benutzeroberfläche. Es generiert fünf Arten von Bildern: Ein 1200×630 Open Graph-Bild für die Startseite (inkl. X Card), optionale Vorschaubilder für einzelne Unterseiten einer Website, eine Product Hunt-Galerie mit 4–6 Slides in 1270×760, einen X-Header in 1500×500 und die dazugehörigen `<meta>`-Tags. Jedes Bild besteht aus einem echten Screenshot der App mit einem großen, lesbaren Titel, dem App-Icon und einem brand-farbenen Hintergrund oder einem hellen Hintergrundbild. Das Skill prüft alle Ausgaben auf korrekte Größen, Alpha-Kanal, Textkontrast, Schriftart, Sicherheitszonen für X und Product Hunt und stellt sicher, dass keine Schriftart-Fallback verwendet wird. Es wird in CLI-Umgebungen wie Claude Code, Cursor und Codex sowie im Terminal eingesetzt und verwendet Playwright für Screenshots und Node.js-Skripte für die Bildgenerierung und Qualitätssicherung. Der Benutzer wird nur dann nach fehlenden Informationen gefragt, wenn diese nicht aus dem Repository ermittelt werden können, und muss keine UI zeichnen oder generieren – nur echte Aufnahmen der App werden verwendet.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abdiraimov-otabek/claude-code-og-image-skill/tree/main/skills/og-images

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Og-Bilder

Drei Arten von Bildern, die alle eine Aufgabe haben: jemanden bei einem Link zum Anhalten bringen und die App auf einen Blick verständlich machen. Jedes ist ein echter Screenshot der App mit einem großen Titel, auf dem Brand-Hintergrund oder einem hellen Hintergrundbild. Die UI ist der Held. Nichts wird gezeichnet außer dem Rahmen.

Ausgaben im launch-assets/og/-Verzeichnis des Benutzer-Repos:

DateiGrößeZweck
og.png1200×630Link-Vorschau für die Startseite.
og-<id>.png1200×630Optional: pro Seite einer Website, gleiches Design, Titel von dieser Seite.
ph/01-<id>.png … 061270×760Product Hunt-Galerie, 4 bis 6 Folien. Folie 1 ist der Held.
x-header.png1500×500X-Header mit Avatar und Telefon-Crop-Zonen freigehalten.
meta.htmlDie <meta>-Tags zum Einfügen in <head>.

Größen und Sicherheitszonen mit Quellen und Daten sind in references/sizes.md.

Wann verwenden

  • Ein Launch benötigt ein Teilen-Bild, eine Product Hunt-Galerie oder einen X-Header.
  • Das aktuelle og:image der Website ist ein Logo auf einer flachen Farbe, oder es gibt keins.
  • Ein Release hat die UI geändert, sodass die Vorschauen aus neuen Screenshots neu gerendert werden müssen.

Screenshots sind Mac-ähnliche Landschaftsfenster oder Inseln; ein porträtierter Telefonbildschirm wird von diesen Karten nicht unterstützt. Nicht für: App Store-Screenshots (ein anderes Skill mit anderen Größen) oder alles, was eine UI benötigt, die die App nicht hat. Dieses Skill zeichnet niemals UI.

Einrichtung (einmalig)

Node 20 oder neuer. Playwright wird im Skill-Ordner installiert, nicht im Benutzer-Repo:

npm install --prefix <skill-folder> [email protected] && npx --prefix <skill-folder> playwright install chromium

Fehlt es, gibt render.mjs diese Zeile aus und beendet sich mit Exit 2.

Schritt 0. Marke

Lese launch-assets/brand.json im Benutzer-Repo. Wenn vorhanden, verwende es. Wenn es fehlt, erkenne jedes Feld aus dem Repo und schreibe die Datei. Frage den Benutzer nur nach dem, was du nicht finden konntest, in einer Nachricht.

{
  "appName": "Halo", "oneLiner": "The Dynamic Island for Mac", "platform": "macos",
  "colors": { "bg": "#f5f5f7", "ink": "#1d1d1f", "accent": "#0071e3" },
  "fonts": { "family": "-apple-system, 'SF Pro Display', sans-serif", "file": null, "google": null },
  "iconPath": "site/assets/icon.png",
  "screenshotDirs": ["launch-assets/captures"],
  "siteUrl": "https://example.com"
}
  • appName, oneLiner: README-Titel und erste Zeile, der <title> und <h1> der Website, Info.plist.
  • colors: die CSS-Variablen der Website, das AccentColor des Asset-Katalogs, Swift Color-Definitionen. Nimm die hellen Werte. Schreibe hex (#0d7f76); konvertiere rgb(), oklch() und hsl() zuerst. Alles, was der Renderer nicht lesen kann, zählt als Grau.
  • fonts.family (ein CSS-Stack), fonts.file (eine Schriftartdatei, die das Repo liefert, ein Pfad relativ zum Repo-Root, der Ordner über launch-assets, oder null), fonts.google (z. B. Geist:wght@400;600, oder null). Verwende die Brand-Schriftart nur, wenn das Repo die Datei liefert; ansonsten den System-Stack oder Google Fonts. Kopiere niemals eine proprietäre Schriftart in das Benutzer-Repo.
  • iconPath: das App-Icon, ein quadratisches PNG (1024 px ist am besten), relativ zum Repo-Root. Suche in den Website-Assets, im AppIcon des Asset-Katalogs, im Favicon-Ordner. Erforderlich: Das Icon und der Name sind auf jedem Bild.
  • siteUrl: wohin meta.html die Bild-URLs verweist. Optional; ohne wird ein Platzhalter in den Tags verwendet.

Schritte

  1. Screenshots. Wiederverwenden, was existiert: launch-assets/captures/, screenshotDirs oder ein früheres launch-assets/store-screenshots/shots.json. Neue nur dann erstellen, wenn keine die folgenden Regeln erfüllen. Suche zuerst nach der eigenen Methode der App, sich selbst zu erfassen: einen Snapshot, Demo- oder Beispieldaten-Flag (rg -i "demo|snapshot|screenshot|marketing" im Quellcode, der README und Package.swift; zum Beispiel MyApp --snapshot <dir> oder MYAPP_DEMO=1). Lese, was ein Flag tut, bevor du es ausführst. Führe niemals etwas aus, das echte Benutzerdaten scannt, bereinigt oder schreibt, und starte niemals eine zweite Kopie einer App, die Live-Status hält. Wenn ein Flag eines davon tun könnte, stoppe und frage. Andernfalls bringe auf einem Mac die App in den Vordergrund in den zu zeigenden Zustand und führe aus: swift <skill-folder>/scripts/capture-window.swift "MyApp" capture.png (das größte sichtbare Fenster der App, kein Schatten, Retina-Pixel; es überspringt ein Notch- oder Menüleisten-App-Panel, das auf einer höheren Fensterebene liegt, und meldet dies). iOS: xcrun simctl status_bar booted override --time 9:41 --batteryState charged --batteryLevel 100, dann xcrun simctl io booted screenshot capture.png, dann xcrun simctl status_bar booted clear.

    Regeln für jeden Screenshot:

    • Echte UI, fokussiert. Das aktive Fenster: farbige Ampeln, eine beleuchtete Seitenleiste. Ein graues, abgedunkeltes Fenster ist ein Fehler.
    • Beruhigt. Kein Zähler in der Mitte, kein Spinner, nichts halb gezeichnet.
    • Neutrale Demodaten. Keine persönlichen Namen, echte Datei-, Projekt- oder Kontonamen, keine Firmennamen anderer Unternehmen (es sei denn, die Website der App nennt diese Integration). Verwende den Demo-Modus, niemals einen Screenshot der echten Sache.
    • Heller Modus, wenn die App einen hat. Dunkle Screenshots sind für reine Dunkelmodus-Apps.
    • 2x Pixel. Eine Karte zeigt einen Screenshot mit höchstens 1,15x seiner eigenen Pixel (der Renderer schlägt darüber fehl), also benötigt ein Fenster etwa 1400 px in der Breite für eine Link-Vorschau und 2000 px für eine Galerie-Folie.
    • Echter Inhalt. Keine leeren Wells, kein Lorem, kein abgeschnittener Text in dem Teil, den der Titel beschreibt.
    • Einer, der klein lesbar ist. Die Link-Vorschau zeigt den Screenshot mit etwa 600 px Breite. Wähle den Screenshot, dessen Hauptpunkt bei dieser Größe sichtbar ist (eine große Zahl, eine klare Liste), nicht ein dichtes Einstellungsfenster. Schneide auf den relevanten Teil zu.
    • Ein SwiftUI ImageRenderer-Screenshot (die Insel einer Notch-App) kommt mit undurchsichtigen gelben Platzhaltern in den Eckflares: setze "clean": true. Für eine auf der Karte schwebende Insel füge "square": true hinzu, das die Eckflares quadratisch bis zu den Körperkanten abschneidet. Schneide mit crop eine leere Notch-Zeile weg.

    Fertig, wenn jeder Screenshot die Liste erfüllt. Lese die Größe jeder Datei (sips -g pixelWidth -g pixelHeight) und sieh sie dir an.

  2. Schreibe die Texte.

    • Link-Titel: der One-Liner der App oder der Titel der Seite selbst, in den Worten der Website: 9 Wörter oder weniger, Satzfall, kein Punkt, kein Gedankenstrich, kein !. Es ist der einzige große Text auf der Karte, also ist kürzer = größer.
    • Seiten: wenn das Repo eine Website mit mehreren Seiten hat, führe node <skill-folder>/scripts/pages.mjs <site-folder> aus. Es gibt den <title> und <h1> jeder Seite aus. Wähle die Seiten, die eine eigene Vorschau wert sind (die Anleitungen, die Preisseite, die größten Funktionen); überspringe Seiten, die ein Produkt eines anderen Unternehmens nennen. Nimm den <h1> oder den kürzeren der beiden, entferne den Site-Name-Suffix und Tags im Stil "(2026)", halte es auf 9 Wörter. Paraphrasiere niemals.
    • Folien: wenn launch-assets/store-screenshots/shots.json existiert, verwendet "ph": { "fromShots": "../store-screenshots/shots.json" } dessen Überschriften, Unterzeilen, Screenshots und Zuschnitte erneut (erste 6 Shots, "limit" ändert das). Ansonsten schreibe 4 bis 6 Folien: Folie 1 sagt, was die App ist, jede weitere hat einen Nutzen und ergibt allein Sinn. Überschrift 6 Wörter oder weniger, eine optionale Unterzeile von einem kurzen Satz.
    • X-Header-Titel: der One-Liner. 6 Wörter oder weniger.
    • Alt-Text: ein Satz, der sagt, was das Bild zeigt. Standard ist <app>: <title>. <subline>; schreibe alt auf den Link, wenn der Screenshot etwas Bemerkenswertes hinzufügt.

    Der Text verwendet die eigenen Worte der Website. Jede Zeile ist von der Website oder README übernommen und gekürzt; jede Zahl, jeder Name und jede Behauptung steht auf der Website. Überprüfe jede Zeile mit rg gegen den Website-Text, bevor du sie behältst.

  3. Schreibe launch-assets/og/og.json.

    {
      "brand": "../brand.json",
      "out": ".",
      "wallpaper": "auto",
      "link": {
        "title": "Ein Mac-Reiniger für Entwickler",
        "capture": "../captures/overview.png",
        "alt": "Shedi, ein Mac-Reiniger für Entwickler: 43,84 GB gefunden, sortiert in sicher zu bereinigen und zuerst prüfen"
      },
      "pages": [
        { "id": "xcode-deriveddata", "title": "Xcode DerivedData löschen", "capture": "../captures/xcode.png" }
      ],
      "ph": { "fromShots": "../store-screenshots/shots.json" },
      "x": { "title": "Ein Mac-Reiniger für Entwickler", "capture": "../captures/overview.png" }
    }
    

    Lasse pages, ph oder x weg, um diese Art zu überspringen. Pfade sind relativ zu og.json. Eine Seite erbt alles von link (Screenshot, Zuschnitt, Layout) und überschreibt, was sie benennt. Optionen auf link, einer Seite, einer Folie oder x:

    • capture (oder captures, bis zu 3, gestapelt), crop ({ x, y, w, h }, 0 bis 1 des Screenshots nach Entfernung transparenter Ränder; crops für mehrere Screenshots), clean, square, radius, width (Screenshotbreite als Anteil der Karte), shadow: false, minCoverage.
    • layout: Link-Karten sind side (Titel links, ein Fenster, das von unten rechts aufsteigt) oder below (Titel zentriert, ein breiter Screenshot darunter). Standardmäßig wird below für einen Screenshot gewählt, der breiter als 2:1 ist, sonst side. Folien sind fit (der gesamte Screenshot, nichts abgeschnitten), bleed (durch die Unterkante beschnitten, für ein Fenster) oder pair (2 oder 3 Screenshots gestapelt). Eine Folie ohne layout und einem einfachen Fenster-Screenshot (kein clean) ist bleed; alles andere ist fit.
    • minCoverage: die Untergrenze für die UI-Abdeckung (Link 0,3, Folie 0,4, Header 0,12). Ein Screenshot, der 80 % der Kartenbreite einnimmt, besteht ohne sie (eine dünne Insel oder Leiste kann nicht höher werden). Senke die Untergrenze nicht, um einen kleinen Screenshot zu verstecken: zeige ihn größer, schneide ihn zu oder wähle einen anderen.
    • Auf einer Folie in fromShots, füge "slides": [{ "id": "<shot id>", ... }] hinzu, um die Optionen einer Folie zu überschreiben.

    Hintergrund, einmal für alle Bilder: "wallpaper": "auto" wählt das mitgelieferte Bild aus, dessen Farbton dem Brand-Akzent am nächsten ist (blau und türkis, grün, warm, pink) und gibt die Auswahl und den Grund aus. Teile dem Benutzer die Auswahl und den Grund mit und dass er sie ändern kann ("wallpaper": "snow" oder ein Pfad zu einem eigenen hellen, ruhigen Bild, mindestens 2400 px breit). Ein grauer Akzent oder einer, der mehr als 50 Grad von jedem Bild entfernt ist, erhält stattdessen das Brand-Feld (der Brand-Hintergrund, mit einem Hauch seines Akzents gewaschen). Lasse den Schlüssel für das Feld weg. Dieses Skill enthält fünf Bilder.

  4. Rendern.

    node <skill-folder>/scripts/render.mjs launch-assets/og/og.json
    

    Eine Ausgabezeile pro PNG: ok oder FAIL, Größe, Dateigewicht, die Schriftart, die den Titel tatsächlich gezeichnet hat, der Kontrast der Wörter gegen die Pixel wirklich dahinter, die Größe und Oberlänge des Titels, die UI-Abdeckung und wie stark der Screenshot und das Hintergrundbild vergrößert wurden. --only link|pages|ph|x rendert nur eine Art (alles andere schlägt fehl). Es schreibt auch meta.html.

    Die Prüfung schlägt fehl bei: einer nicht exakten Größe, einem Alpha-Kanal, einer Datei über 5 MB, Textkontrast unter 4,5:1 (es gibt keinen Scrim; wähle ein helleres Hintergrundbild oder dunklere Tinte), einem Titel, dessen Oberlänge unter dem Minimum liegt (Link 40 px, Folie 38 px, Header 36 px, damit er in einer 600 px breiten Vorschau noch lesbar ist) oder der mehr Zeilen benötigt als passen, überlangem oder mit Gedankenstrich (einem Gedankenstrich, " - " oder "--") oder !-Text, einem Screenshot, der über 1,15x vergrößert wurde, oder einem Hintergrundbild über 1,2x, UI-Abdeckung unter der Grenze, es sei denn, der Screenshot nimmt 80 % der Kartenbreite ein (gemessen an den Inhalts-Pixeln des Screenshots, nicht an seinem Rahmen, sodass leere schwarze oder weiße Bereiche nicht zählen), etwas außerhalb des X-Sicherheitsbereichs oder innerhalb der Avatar-Zone und einem Schriftart-Fallback: die erste genannte Familie von fonts.family muss die Schriftart sein, die den Titel gezeichnet hat ("Inter, sans-serif" ohne Datei würde SF Pro zeichnen: FAIL). Ein Stack, der mit -apple-system oder system-ui beginnt, bedeutet die Systemschriftart und schlägt nur bei einem Fallback wie Helvetica oder Arial fehl. Behebe jedes FAIL in og.json und rendere erneut.

  5. QA-Durchlauf. Erforderlich und auf den Dateien durchgeführt, nicht auf der Konfiguration.

    1. Größe und Alpha: sips -g pixelWidth -g pixelHeight -g hasAlpha <jede Datei>. Exakte Größen aus sizes.md, hasAlpha: no.
    2. Ansehen: Öffne jedes PNG mit dem Lese-Tool in voller Größe. Führe dann node <skill-folder>/scripts/preview.mjs launch-assets/og aus und öffne _preview-600.png und _preview-300.png (jedes Bild bei 600 und 300 px Breite, wie ein Feed es zeigt), lösche dann die beiden Dateien. Prüfe für jedes Bild:
      • Der Titel ist bei 300 px lesbar und nichts ist abgeschnitten oder allein in einer zweiten Zeile.
      • Die Schriftart in der Ausgabezeile ist die, die du angefordert hast.
      • Der Screenshot ist scharf, zeigt den Punkt des Titels, hat keinen abgeschnittenen Text und keine persönlichen Daten.
      • Namen: kein Name oder Logo eines Wettbewerbers oder anderer Unternehmen, es sei denn, die Website nennt diese Integration; keine persönlichen Namen.
      • Wörter: Jede Zeile ist der eigene Wortlaut der Website, gekürzt; jede Zahl ist auf der Website.
      • X-Header: Die linke untere Ecke (x unter 420, y über 300) ist frei für das Profilfoto; der Inhalt sitzt im mittleren Band, weg von den oberen und unteren 70 px. Überprüfe es gegen sizes.md und, wenn möglich, auf dem echten Profil.
      • Set: Die Folien lesen sich wie eine Familie; keine zwei machen denselben Punkt.
    3. Behebe und rendere erneut, sieh dir dann diese Datei erneut an.
    4. Erst dann melden: die Dateiliste, die sips-Ausgabe und alles, was du nicht verifizieren konntest. Sage dem Benutzer, die PNGs auf die Website zu kopieren, meta.html in <head> einzufügen und die zwischengespeicherte Vorschau im Debugger jeder Plattform zu aktualisieren.

Betrachtungsregeln

  • Hell zuerst. Ein helles Hintergrundbild oder das Brand-Feld, Tinte dunkel darauf. Kein dunkler Hintergrund mit Neon.
  • Kein Leuchten, kein Halo. Tiefe ist eine 1 px Kante und neutrale schwarze Schatten bei niedriger Deckkraft.
  • Ein Job pro Bild. Ein Titel, ein Screenshot (oder ein Paar), höchstens eine Unterzeile.
  • Große Schrift. Der Titel ist das, was in einer Miniaturansicht überlebt. Kurzer Text ermöglicht große Schrift.
  • Nur echte Screenshots. Die UI wird niemals gezeichnet, neu gezeichnet oder generiert.

Verwandte Skills