CommunityBildgithub.com

share-cards

Erstellt für jede Seite einer Website ein Open-Graph-Vorschaubild (1200×630 Pixel) aus einer HTML-Vorlage und fügt beim Build die jeweiligen Meta-Tags (Titel, Beschreibung, kanonische URL, og:*, twitter:*) in das HTML ein – für korrekte Linkvorschauen in Chat-Apps und sozialen Netzwerken.

Was ist share-cards?

Dieses Skill löst das bekannte Problem, dass Single-Page-Anwendungen (SPAs) beim Teilen von Links in Chat-Apps oder sozialen Medien immer dieselbe Vorschau anzeigen, weil Crawler kein JavaScript ausführen. „share-cards“ erledigt zwei Aufgaben: Es rendert für jede definierte Seite ein individuelles 1200×630 Pixel großes Open-Graph-Bild (JPEG) und injiziert die zugehörigen Meta-Tags (Titel, Beschreibung, kanonische URL, og:*, twitter:*) in die jeweilige HTML-Datei beim Build. Das Skill unterstützt Frameworks wie Vite (mit einem eigenen Plugin), bietet drei Standard-Templates (editorial, minimal, technical) und erlaubt eigene Vorlagen. Der Workflow umfasst Schritte wie Prüfung der Umgebung, Initialisierung mit einer Konfigurationsdatei, Definition der Seiteninhalte (Titel, Beschreibung, Kartentitel), Rendern der Bilder, Vorschau, Einfügen der Tags und Integration in den Build-Prozess. Abschließende Verifikation stellt die Korrektheit sicher. Es wird direkt über die Kommandozeile ($S/cards) oder via Vite-Plugin genutzt.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/VinVirtual/share-cards/tree/HEAD

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

Was macht share-cards?

Vorschaucrawler (Chat-Apps, soziale Netzwerke, Suchmaschinen) lesen das HTML, das ein Server ausliefert, und führen kein JavaScript aus. Eine Single-Page-App sendet für jede Adresse dasselbe HTML, daher zeigt jeder Link dieselbe Vorschau. share-cards behebt beide Probleme:

  1. Rendern: eine HTML-Vorlage + eine Liste von Seiten → ein 1200×630 JPEG pro Seite, gezeichnet in einem Headless-Browser.
  2. Inject: das gebaute index.html → eine HTML-Datei pro Seite, jede mit eigenem <title>, Beschreibung, kanonischer URL, og:*- und twitter:*-Tags.

Skill-Ordner: ~/.claude/skills/share-cards/ (im Folgenden als $S bezeichnet). Jeder Befehl ist $S/cards <command> [dir], wobei [dir] die cards.config.json enthält. $S/cards help listet alle Befehle auf.

$S/cards                    die Kommandozeile
$S/lib/                     Konfiguration, Tag-Injektion, Rendering, Verifikation, Vorschau, Rewrites
$S/templates/               editorial.html, minimal.html, technical.html, runtime.js
$S/vite-plugin.mjs          führt inject nach `vite build` aus
$S/references/templates.md  Slots, Variablen und Anleitung für eigene Vorlagen
$S/examples/site/           eine 4-Seiten-Beispielseite mit Karten und injizierten Seiten
$S/README.md                Konfigurationsreferenz, Framework-Hinweise, Grenzen

Arbeitsablauf

  1. Maschine prüfen: $S/cards check. Nur render und preview benötigen einen Browser.
  2. Seiten finden: Lies den Router oder den Inhaltsordner des Projekts und liste jede öffentliche Adresse auf. Finde, wo statische Dateien ausgeliefert werden (public/, static/) und wohin der Build geht (dist/, build/, out/).
  3. Gerüst erstellen: $S/cards init <project> (--mjs hinzufügen, wenn die Seitenliste aus den eigenen Routen oder Inhaltsdaten des Projekts gebaut werden soll, damit sie nicht auseinanderdriftet). Setze siteUrl (die echte https://-Origin), siteName, imageDir (innerhalb des statischen Ordners, z. B. public/og), imageUrlPath (wo dieser Ordner ausgeliefert wird, z. B. /og) und dist.
  4. Jeder Seiteneintrag schreiben:
    • title: der vollständige Seitentitel, wie er in der Vorschau erscheinen soll.
    • description: ein Satz, maximal 160 Zeichen.
    • cardTitle: die Wörter, die auf der Karte gezeichnet werden. Kurz halten (ca. 2 bis 6 Wörter). Mit *Sternchen* markierte Wörter werden in der Akzentfarbe gezeichnet.
    • cardDescription (optional, eine kürzere Zeile für die Karte), kicker (kleines Label), art (eine Bilddatei aus dem Projekt), template (seitenweise Überschreibung).
    • Erfinde niemals Fakten, Zahlen oder Zitate für diese Felder. Übernimm die Wörter aus der Seite selbst.
  5. Vorlage und Design wählen: editorial (Papier, schweres Serif), minimal (weiß, ruhig), technical (dunkel, Monospace). Setze theme auf die eigenen Farben des Projekts. Für alles andere führe $S/cards eject <name> card.html aus, bearbeite es und setze "template": "./card.html". Siehe references/templates.md.
  6. Rendern: $S/cards render <project>. Lies jede Warnung: Ein abgeschnittener Titel oder Beschreibung bedeutet, dass der Text gekürzt werden muss.
  7. Ergebnis ansehen: $S/cards preview <project> schreibt cards-preview/contact-sheet.png und chat-preview.png. Lies beide PNGs. Prüfe jede Karte auf abgeschnittene Wörter, Überfüllung, schwachen Kontrast und versteckte Bilder. Korrigiere und rendere erneut. Sage dem Benutzer nicht, dass die Karten richtig aussehen, bevor du sie überprüft hast.
  8. Seitengerüst vorbereiten: inject füllt Tags, die bereits vorhanden sind, und schlägt fehl, wenn eines fehlt. Führe $S/cards tags <project> aus und füge den Block in den <head> der Quell-index.html ein, wobei alte Share-Tags ersetzt werden (oder --add-missing verwenden).
  9. In den Build einbinden:
    • Vite: füge shareCards() aus $S/vite-plugin.mjs zu plugins hinzu (siehe README).
    • Alles andere: führe $S/cards inject <project> nach dem Build-Befehl aus.
  10. Host-Regeln: Wenn der Host einen Catch-All-Rewrite auf /index.html hat, drucke Seitenregeln mit $S/cards rewrites vercel|netlify|netlify-toml <project> und platziere sie vor dem Catch-All. Zeige dem Benutzer die Regeln; bearbeite die Host-Konfiguration nicht ohne Ansage.
  11. Verifizieren: Baue die Seite, dann $S/cards verify <project>. Es muss mit All good. enden.
  12. Dem Benutzer mitteilen, was noch zu tun ist: Deployen, dann einen echten Link in eine Chat-App einfügen. Vorschauen werden von jeder App zwischengespeichert, manchmal tagelang; setze "versionImages": true, um die Bildadresse bei jeder Änderung einer Karte zu ändern.

Regeln

  • siteUrl muss die Produktions-Origin sein. Vorschaubilder benötigen absolute https://-Adressen.
  • Rendere Karten vor dem Build, damit der Build sie kopiert, und committe die Karten sowie cards.lock.json. CI benötigt dann keinen Browser.
  • Während des Renderns wird nichts aus dem Netzwerk geholt, es sei denn, die Konfiguration setzt "allowNetwork": true. Web-Schriftarten müssen lokale Dateien sein, die unter fonts aufgelistet sind.
  • Schriftarten verwenden standardmäßig System-Stapel, sodass auf anderen Maschinen gezeichnete Karten abweichen können. Für identische Ausgabe überall füge Schriftartdateien zum Projekt hinzu (überprüfe die Lizenz) und liste sie unter fonts auf.
  • Sage klar, was nicht überprüft wurde: der echte Crawler jeder App und die Routing-Konfiguration des Hosts nach dem Deploy.

Verwandte Skills