CommunityImagegithub.com

og-images

Génère les images de lancement d'une application à partir de son interface réelle : aperçu de lien 1200×630 (Open Graph et X card) avec titre lisible, icône et capture réelle, galerie Product Hunt de 4 à 6 diapositives en 1270×760, bannière X en 1500×500, et balises meta.

Qu'est-ce que og-images ?

Ce skill crée automatiquement les images de partage et de réseaux sociaux pour le lancement d'une application, en utilisant l'interface réelle de l'application plutôt que des maquettes dessinées. Il produit un aperçu de lien (Open Graph et X card) de 1200×630 pixels avec un titre large et lisible, l'icône de l'application et une capture d'écran réelle. Il génère également une galerie Product Hunt de 4 à 6 diapositives en 1270×760 pixels, une bannière X (Twitter) de 1500×500 pixels, et les balises meta HTML correspondantes. Le skill prend en charge les applications macOS et iOS, utilise Playwright pour les rendus côté serveur, et vérifie automatiquement la conformité des images (taille exacte, absence de canal alpha, contraste du texte, taille du titre, zones de sécurité, absence de fallback de police). Il est conçu pour Claude Code, Cursor et d'autres agents IA, et fonctionne en analysant le dépôt de l'utilisateur pour détecter les couleurs de marque, les polices et les captures existantes avant de produire les assets prêts à l'emploi.

Compatible avec~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 Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Images Og

Trois types d'images qui font toutes le même travail : faire en sorte que quelqu'un s'arrête sur un lien et comprenne l'application en un coup d'œil. Chacune est une capture réelle de l'application avec un titre large, sur le fond de la marque ou un papier peint lumineux. L'interface est le héros. Rien n'est dessiné à part le cadre.

Sorties, dans launch-assets/og/ du dépôt de l'utilisateur :

FichierTailleDescription
og.png1200×630L'aperçu de lien pour la page d'accueil.
og-<id>.png1200×630Optionnel : un par page d'un site, même design, titre de cette page.
ph/01-<id>.png … 061270×760Galerie Product Hunt, 4 à 6 diapositives. La diapositive 1 est le héros.
x-header.png1500×500Bannière X avec l'avatar et les zones de recadrage téléphone dégagées.
meta.htmlLes balises <meta> à coller dans <head>.

Les tailles et zones de sécurité, avec sources et dates, se trouvent dans references/sizes.md.

Quand l'utiliser

  • Un lancement a besoin d'une image de partage, d'une galerie Product Hunt ou d'une bannière X.
  • L'actuelle og:image du site est un logo sur une couleur unie, ou il n'y en a pas.
  • Une version a changé l'interface, donc les aperçus sont re-rendus à partir de nouvelles captures.

Les captures sont des fenêtres ou îlots de style macOS en paysage ; un écran de téléphone en portrait n'est pas pris en charge par ces cartes. Pas pour : les captures d'écran App Store (un skill différent, avec des tailles différentes), ou tout ce qui nécessite une interface que l'application n'a pas. Ce skill ne dessine jamais d'interface.

Configuration (une fois)

Node 20 ou plus récent. Playwright va dans le dossier de ce skill, pas dans le dépôt de l'utilisateur :

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

Si Playwright est manquant, render.mjs imprime cette ligne et se termine avec le code 2.

Étape 0. Marque

Lire launch-assets/brand.json dans le dépôt de l'utilisateur. S'il existe, l'utiliser. S'il est manquant, détecter chaque champ à partir du dépôt et écrire le fichier. Demander à l'utilisateur uniquement ce que vous n'avez pas trouvé, en un seul message.

{
  "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 : titre et première ligne du README, <title> et <h1> du site, Info.plist.
  • colors : les variables CSS du site, l'AccentColor du catalogue d'assets, les définitions Swift Color. Prendre les valeurs light. Écrire en hexadécimal (#0d7f76) ; convertir d'abord rgb(), oklch() et hsl(). Tout ce que le rendu ne peut pas lire compte comme gris.
  • fonts.family (une pile CSS), fonts.file (un fichier de police livré dans le dépôt, un chemin relatif à la racine du dépôt, le dossier au-dessus de launch-assets, ou null), fonts.google (par exemple Geist:wght@400;600, ou null). Utiliser la police de la marque uniquement si le dépôt livre le fichier ; sinon la pile système ou Google Fonts. Ne jamais copier une police propriétaire dans le dépôt de l'utilisateur.
  • iconPath : l'icône de l'application, un PNG carré (1024 px c'est le mieux), relatif à la racine du dépôt. Chercher dans les assets du site, l'AppIcon du catalogue d'assets, le dossier favicon. Requis : l'icône et le nom sont sur chaque image.
  • siteUrl : où meta.html pointe les URLs des images. Optionnel ; sans lui les balises portent un placeholder.

Étapes

  1. Captures. Réutiliser ce qui existe : launch-assets/captures/, screenshotDirs, ou un launch-assets/store-screenshots/shots.json antérieur. En prendre de nouvelles seulement quand aucune ne passe les règles ci-dessous. Chercher d'abord la propre façon de l'application de se capturer elle-même : un flag snapshot, démo ou données d'exemple (rg -i "demo|snapshot|screenshot|marketing" dans le code source, le README et Package.swift ; par exemple MyApp --snapshot <dir> ou MYAPP_DEMO=1). Lire ce que fait un flag avant de l'exécuter. Ne jamais exécuter quoi que ce soit qui scanne, nettoie ou écrit des données utilisateur réelles, et ne jamais lancer une deuxième copie d'une application qui conserve un état en direct. Si un flag pourrait faire l'un ou l'autre, s'arrêter et demander. Sinon, sur un Mac, amener l'application au premier plan dans l'état à montrer et exécuter swift <skill-folder>/scripts/capture-window.swift "MonApp" capture.png (la plus grande fenêtre à l'écran de l'application, sans ombre, pixels Retina ; elle ignore un panneau d'encoche ou de barre de menu, qui se trouve sur une couche de fenêtre supérieure, et le signale). iOS : xcrun simctl status_bar booted override --time 9:41 --batteryState charged --batteryLevel 100, puis xcrun simctl io booted screenshot capture.png, puis xcrun simctl status_bar booted clear.

    Règles pour chaque capture :

    • Interface réelle, ciblée. La fenêtre active : feux de circulation colorés, barre latérale allumée. Une fenêtre grise et atténuée est un échec.
    • Stabilisée. Pas de compteur en cours, pas de spinner, rien à moitié dessiné.
    • Données de démonstration neutres. Pas de noms personnels, de vrais fichiers, de noms de projets ou de comptes, pas de noms de produits d'autres sociétés (sauf si le site de l'application nomme cette intégration). Utiliser le mode démo, jamais une capture de la vraie chose.
    • Mode clair si l'application en a un. Les captures sombres sont pour les applications uniquement sombres.
    • Pixels 2x. Une carte montre une capture à au plus 1,15x ses propres pixels (le rendu échoue au-dessus), donc une fenêtre a besoin d'environ 1400 px de large pour un aperçu de lien et 2000 px pour une diapositive de galerie.
    • Contenu réel. Pas de puits vides, pas de lorem, pas de texte tronqué dans la partie dont le titre parle.
    • Qui se lit en petit. L'aperçu de lien montre la capture à environ 600 px de large. Choisir la capture dont le point principal est visible à cette taille (un grand chiffre, une liste claire), pas un panneau de paramètres dense. Rogner à la partie qui compte.
    • Une capture ImageRenderer SwiftUI (un îlot d'application d'encoche) vient avec des placeholders jaunes opaques dans ses coins : définir "clean": true. Pour un îlot flottant sur la carte, ajouter "square": true, qui carre les coins jusqu'aux bords du corps. Rogner toute rangée d'encoche vide avec crop.

    Terminé lorsque chaque capture passe la liste. Lire la taille de chaque fichier (sips -g pixelWidth -g pixelHeight) et la regarder.

  2. Écrire les mots.

    • Titre du lien : le slogan de l'application ou le titre de la page, dans les mots du site : 9 mots ou moins, casse de phrase, pas de point final, pas de tiret, pas de !. C'est le seul grand texte sur la carte, donc plus c'est court, plus c'est grand.
    • Pages : si le dépôt a un site avec plusieurs pages, exécuter node <skill-folder>/scripts/pages.mjs <dossier-site>. Il imprime le <title> et le <h1> de chaque page. Choisir les pages qui valent un aperçu propre (les guides, la page de tarification, les plus grandes fonctionnalités) ; sauter les pages qui nomment le produit d'une autre société. Prendre le <h1> ou le plus court des deux, supprimer le suffixe du nom du site et les balises de style "(2026)", garder à 9 mots. Ne jamais paraphraser.
    • Diapositives : si launch-assets/store-screenshots/shots.json existe, "ph": { "fromShots": "../store-screenshots/shots.json" } réutilise ses titres, sous-titres, captures et recadrages (6 premières captures, "limit" change cela). Sinon, écrire 4 à 6 diapositives : la diapositive 1 dit ce qu'est l'application, chaque suivante a un avantage et a du sens seule. Titre 6 mots ou moins, un sous-titre optionnel d'une phrase courte.
    • Titre de la bannière X : le slogan. 6 mots ou moins.
    • Texte alternatif : une phrase qui dit ce que l'image montre. Par défaut <app>: <titre>. <sous-titre> ; écrire alt sur le lien lorsque la capture ajoute quelque chose qui vaut la peine d'être dit.

    La copie utilise les propres mots du site. Chaque ligne est tirée du site ou du README et raccourcie ; chaque nombre, nom et affirmation est sur le site. Vérifier chaque ligne avec rg sur la copie du site avant de la conserver.

  3. Écrire launch-assets/og/og.json.

    {
      "brand": "../brand.json",
      "out": ".",
      "wallpaper": "auto",
      "link": {
        "title": "Un nettoyeur Mac pour développeurs",
        "capture": "../captures/apercu.png",
        "alt": "Shedi, un nettoyeur Mac pour développeurs : 43,84 Go trouvés, triés en "à nettoyer sans risque" et "à vérifier d'abord""
      },
      "pages": [
        { "id": "xcode-deriveddata", "title": "Effacer DerivedData de Xcode", "capture": "../captures/xcode.png" }
      ],
      "ph": { "fromShots": "../store-screenshots/shots.json" },
      "x": { "title": "Un nettoyeur Mac pour développeurs", "capture": "../captures/apercu.png" }
    }
    

    Laisser de côté pages, ph ou x pour sauter ce type. Les chemins sont relatifs à og.json. Une page hérite de tout de link (capture, recadrage, disposition) et écrase ce qu'elle nomme. Options sur link, une page, une diapositive ou x :

    • capture (ou captures, jusqu'à 3, empilées), crop ({ x, y, w, h }, 0 à 1 de la capture après suppression des marges transparentes ; crops pour plusieurs captures), clean, square, radius, width (largeur de capture en part de la carte), shadow: false, minCoverage.
    • layout : les cartes lien sont side (titre à gauche, fenêtre s'élevant du bas à droite) ou below (titre centré, large capture en dessous). Par défaut, choisit below pour une capture plus large que 2:1, side sinon. Les diapositives sont fit (toute la capture, rien coupé), bleed (coupé par le bord inférieur, pour une fenêtre) ou pair (2 ou 3 captures empilées). Une diapositive sans layout et une capture de fenêtre simple (sans clean) est bleed ; tout le reste est fit.
    • minCoverage : le seuil minimal pour la couverture UI (lien 0.3, diapositive 0.4, en-tête 0.12). Une capture qui couvre 80% de la largeur de la carte passe sans cela (un îlot ou une barre fine ne peut pas devenir plus haut). Ne pas abaisser le seuil pour cacher une petite capture : l'afficher plus grande, la rogner ou en choisir une autre.
    • Sur une diapositive dans fromShots, ajouter "slides": [{ "id": "<id capture>", ... }] pour écraser les options d'une diapositive.

    Arrière-plan, une fois pour toutes les images : "wallpaper": "auto" choisit l'image fournie dont la teinte est la plus proche de la couleur d'accentuation de la marque (bleu et sarcelle, vert, chaud, rose) et imprime le choix et la raison. Informer l'utilisateur du choix et de la raison, et qu'il peut le changer ("wallpaper": "neige", ou un chemin vers sa propre image lumineuse et calme, d'au moins 2400 px de large). Une accentuation grise, ou à plus de 50 degrés de chaque image, obtient le champ de la marque à la place (le fond de la marque lavé avec un peu de son accentuation). Laisser la clé de côté pour le champ. Ce skill fournit cinq images.

  4. Rendu.

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

    Une ligne de sortie par PNG : ok ou FAIL, taille, poids du fichier, la police qui a réellement dessiné le titre, le contraste des mots par rapport aux pixels réellement derrière eux, la taille et la hauteur de capitale du titre, la couverture UI et à quel point la capture et le papier peint ont été agrandis. --only link|pages|ph|x rend un seul type (tout le reste échoue). Il écrit aussi meta.html.

    Les gardes échouent : une taille qui n'est pas exacte, un canal alpha, un fichier de plus de 5 Mo, un contraste de texte inférieur à 4.5:1 (il n'y a pas de voile ; choisir un papier peint plus pâle ou une encre plus foncée), un titre dont la hauteur de capitale est inférieure au minimum (lien 40 px, diapositive 38 px, en-tête 36 px, pour qu'il reste lisible dans un aperçu de 600 px de large) ou qui nécessite plus de lignes que possible, une copie trop longue ou avec tiret (tiret, " - " ou "--") ou !, une capture agrandie de plus de 1,15x ou un papier peint de plus de 1,2x, une couverture UI inférieure au seuil sauf si la capture couvre 80% de la largeur de la carte (mesurée sur les pixels de contenu de la capture, pas sur sa boîte, donc les zones noires ou blanches vides ne comptent pas), tout ce qui est en dehors de la zone de sécurité X ou à l'intérieur de la zone d'avatar, et un fallback de police : la première famille nommée de fonts.family doit être la police qui a dessiné le titre ("Inter, sans-serif" sans fichier dessinerait SF Pro : FAIL). Une pile qui commence par -apple-system ou system-ui signifie la police système et échoue uniquement sur un fallback comme Helvetica ou Arial. Corriger chaque FAIL dans og.json et rendre à nouveau.

  5. Contrôle qualité. Requis, et effectué sur les fichiers, pas sur la configuration.

    1. Taille et alpha : sips -g pixelWidth -g pixelHeight -g hasAlpha <chaque fichier>. Tailles exactes depuis sizes.md, hasAlpha: no.
    2. Regarder : ouvrir chaque PNG avec l'outil de lecture en taille réelle. Puis node <skill-folder>/scripts/preview.mjs launch-assets/og et ouvrir _preview-600.png et _preview-300.png (chaque image à 600 et 300 px de large, comme un fil la montre), puis supprimer les deux fichiers. Pour chaque image, vérifier :
      • Le titre est lisible à 300 px et rien n'est coupé ou seul sur une deuxième ligne.
      • La police dans la ligne de sortie est celle que vous avez demandée.
      • La capture est nette, montre le point du titre, n'a pas de texte tronqué et pas de données personnelles.
      • Noms : pas de nom ou logo de concurrent ou d'autre société sauf si le site nomme cette intégration ; pas de noms personnels.
      • Mots : chaque ligne est le propre libellé du site, raccourci ; chaque nombre est sur le site.
      • Bannière X : le coin inférieur gauche (x inférieur à 420, y supérieur à 300) est dégagé pour la photo de profil ; le contenu se situe dans la bande du milieu, loin du haut et du bas de 70 px. Vérifier par rapport à sizes.md et, si possible, sur le vrai profil.
      • Ensemble : les diapositives se lisent comme une famille ; il n'y en a pas deux qui font le même point.
    3. Corriger et rendre à nouveau, puis regarder ce fichier à nouveau.
    4. Seulement ensuite rapporter : la liste des fichiers, la sortie sips, et tout ce que vous n'avez pas pu vérifier. Dire à l'utilisateur de copier les PNG sur le site, de coller meta.html dans <head>, et de rafraîchir l'aperçu mis en cache dans le débogueur de chaque plateforme.

Règles de look

  • Clair d'abord. Un papier peint lumineux ou le champ de la marque, encre foncée dessus. Pas de fond sombre avec néon.
  • Pas de lueur, pas de halo. La profondeur est un bord de 1 px et des ombres noires neutres à faible opacité.
  • Un travail par image. Un titre, une capture (ou une paire), au plus un sous-titre.
  • Grande typographie. Le titre est ce qui survit à une vignette. Une copie courte est ce qui lui permet d'être grand.
  • Captures réelles uniquement. L'interface n'est jamais dessinée, redessinée ou générée.

Skills associés