OG画像 は何をしますか?
3種類の画像。どれも1つの仕事をします。リンクを見た人が立ち止まり、一目でアプリを理解できるようにすることです。 それぞれが、大きなタイトルを持つアプリの実際のキャプチャで、ブランドのフィールドか明るい壁紙の上に配置されます。UIが主役です。フレーム以外は何も描画しません。
出力先は、ユーザーのリポジトリ内の launch-assets/og/ です。
| ファイル | サイズ | 説明 |
|---|---|---|
og.png | 1200×630 | ホームページのリンクプレビュー。 |
og-<id>.png | 1200×630 | オプション:サイトのページごとに1枚。同じデザインで、タイトルはそのページのもの。 |
ph/01-<id>.png … 06 | 1270×760 | Product Huntギャラリー。4~6枚のスライド。スライド1がヒーロー。 |
x-header.png | 1500×500 | Xヘッダー。アバターと電話画面のクロップゾーンはクリアに。 |
meta.html | <head> に貼り付ける <meta> タグ。 |
サイズ、セーフゾーン、ソース、日付は references/sizes.md にあります。
使用するタイミング
- ローンチに共有画像、Product Huntギャラリー、Xヘッダーが必要なとき。
- サイトの現在の
og:imageがベタ塗りのロゴだけだったり、存在しないとき。 - リリースでUIが変更され、新しいキャプチャからプレビューを再レンダリングするとき。
キャプチャはMacスタイルの横長ウィンドウまたはアイランドです。ポートレートの電話画面はこれらのカードではサポートされていません。 以下には使用しません:App Storeのスクリーンショット(別のスキル、異なるサイズ)、またはアプリにないUIが必要なもの。このスキルはUIを描画しません。
セットアップ(初回のみ)
Node 20以降が必要です。Playwrightはこのスキルのフォルダにインストールします。ユーザーのリポジトリにはインストールしません。
npm install --prefix <skill-folder> [email protected] && npx --prefix <skill-folder> playwright install chromium
不足している場合、render.mjs がこの行を出力して終了コード2で終了します。
ステップ0. ブランド
ユーザーのリポジトリ内の launch-assets/brand.json を読み込みます。存在すればそれを使用します。存在しない場合は、リポジトリから各フィールドを検出してファイルを作成します。見つからなかった分だけを、1つのメッセージでユーザーに質問します。
{
"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のタイトルと最初の行、サイトの<title>と<h1>、Info.plist。colors: サイトのCSS変数、アセットカタログのAccentColor、SwiftのColor定義。ライト 値を取得します。16進数で記述します(#0d7f76)。rgb()、oklch()、hsl()は最初に変換します。レンダラーが読み取れないものはグレーとして扱われます。fonts.family(CSSスタック)、fonts.file(リポジトリが同梱するフォントファイル。リポジトリルートからの相対パス、launch-assetsの1つ上のフォルダ、またはnull)、fonts.google(例:Geist:wght@400;600、またはnull)。リポジトリがファイルを同梱している場合のみ、ブランドのフォントを使用します。それ以外の場合はシステムスタックまたはGoogle Fontsを使用します。プロプライエタリなフォントを決してユーザーのリポジトリにコピーしないでください。iconPath: アプリアイコン。正方形のPNG(1024pxが最適)。リポジトリルートからの相対パス。サイトのアセット、アセットカタログのAppIcon、ファビコンフォルダを探します。必須: アイコンと名前はすべての画像に含まれます。siteUrl:meta.htmlが画像URLを指す場所。オプション。これがないとタグはプレースホルダーを保持します。
手順
-
キャプチャ. 既存のものを再利用します:
launch-assets/captures/、screenshotDirs、または以前のlaunch-assets/store-screenshots/shots.json。以下のルールを満たすものが一つもない場合のみ、新しいキャプチャを撮影します。まず、アプリ自身のキャプチャ方法を探します: スナップショット、デモ、サンプルデータフラグ(ソース、README、Package.swiftでrg -i "demo|snapshot|screenshot|marketing"を実行。例:MyApp --snapshot <dir>またはMYAPP_DEMO=1)。フラグが何をするのかを実行前に読みます。スキャン、クリーニング、実際のユーザーデータの書き込みを行うものは決して実行せず、ライブ状態を保持するアプリの2つ目のコピーを起動しないでください。 フラグがどちらかに該当する可能性がある場合は、停止して質問します。それ以外の場合、Macでは、表示する状態でアプリを前面に持ってきて、以下を実行します。swift <skill-folder>/scripts/capture-window.swift "MyApp" capture.png(画面上のアプリの最大ウィンドウ、影なし、Retinaピクセル。ノッチやメニューバーアプリのパネルはスキップします。これらは高いウィンドウレイヤーにあり、その旨を出力します)。iOSの場合:xcrun simctl status_bar booted override --time 9:41 --batteryState charged --batteryLevel 100、次にxcrun simctl io booted screenshot capture.png、次にxcrun simctl status_bar booted clear。すべてのキャプチャのルール:
- 実際のUI、フォーカスしていること。 アクティブウィンドウ:カラフルな信号、ハイライトされたサイドバー。グレーで薄暗いウィンドウは不合格。
- 安定していること。 途中のカウンター、スピナー、半分だけ描画されたものがないこと。
- ニュートラルなデモデータ。 個人名、実際のファイル、プロジェクト、アカウント名、他社の製品名(アプリ自身のサイトがその統合を挙げている場合を除く)。デモモードを使用し、実際のもののスクリーンショットは使用しないでください。
- ライトモード(アプリにライトモードがある場合)。ダークキャプチャはダーク専用アプリのみ。
- 2xピクセル。 カードはキャプチャを最大で自身のピクセルの1.15倍まで表示します(それを超えるとレンダリングは失敗します)。そのため、リンクプレビューには約1400px幅、ギャラリースライドには2000px幅のウィンドウが必要です。
- 実際のコンテンツ。 空のウェル、lorem ipsum、タイトルが言及している部分のテキストが省略されていないこと。
- 小さくても読めるもの。 リンクプレビューは約600px幅でキャプチャを表示します。そのサイズで主要なポイントが見えるキャプチャを選んでください(大きな数字、明確なリスト)。高密度な設定ペインは避けてください。重要な部分にトリミングしてください。
- SwiftUIの
ImageRendererキャプチャ(ノッチアプリのアイランド)には、コーナーフレアに不透明な黄色のプレースホルダーが付属しています。"clean": trueを設定してください。カード上に浮かぶアイランドの場合は、"square": trueを追加します。これにより、コーナーフレアを本体の端まで正方形に切り詰めます。空のノッチ行はcropで切り取ってください。
各キャプチャがリストを満たしたら完了です。すべてのファイルのサイズを読み取り(
sips -g pixelWidth -g pixelHeight)、目視で確認してください。 -
文章を書く。
- リンクタイトル: アプリのワンライナー、またはそのページ自身のタイトル。サイトの文言を使用します:9語以内、文頭のみ大文字、ピリオドなし、ダッシュなし、
!なし。カード上の唯一の大きなテキストなので、短いほど大きく表示されます。 - ページ: リポジトリに複数ページのサイトがある場合、
node <skill-folder>/scripts/pages.mjs <site-folder>を実行します。各ページの<title>と<h1>を出力します。独自のプレビューに値するページ(ガイド、価格ページ、最大の機能)を選びます。他社の製品名を挙げているページはスキップします。<h1>または2つのうち短い方を取得し、サイト名の接尾辞や「(2026)」スタイルのタグを削除し、9語以内に収めます。決して言い換えないでください。 - スライド:
launch-assets/store-screenshots/shots.jsonが存在する場合、"ph": { "fromShots": "../store-screenshots/shots.json" }はその見出し、サブライン、キャプチャ、クロップを再利用します(最初の6ショット、"limit"で変更可能)。それ以外の場合は4~6枚のスライドを作成します。スライド1はアプリが何かを説明し、後続の各スライドは1つの利点を持ち、単独で意味をなします。見出しは6語以内、オプションのサブラインは1つの短い文。 - Xヘッダータイトル: ワンライナー。6語以内。
- 代替テキスト: 画像が何を示しているかを一文で。デフォルトは
<app>: <title>. <subline>。キャプチャに追加で言及する価値がある場合は、リンクにaltを記述します。
コピーはサイト自身の文言を使用します。 すべての行はサイトまたはREADMEから取得し、短縮します。すべての数字、名前、主張はサイト上にあります。各ラインを保持する前に、
rgでサイトのコピーと照合してください。 - リンクタイトル: アプリのワンライナー、またはそのページ自身のタイトル。サイトの文言を使用します:9語以内、文頭のみ大文字、ピリオドなし、ダッシュなし、
-
launch-assets/og/og.jsonを書く。{ "brand": "../brand.json", "out": ".", "wallpaper": "auto", "link": { "title": "A Mac cleaner for developers", "capture": "../captures/overview.png", "alt": "Shedi, a Mac cleaner for developers: 43.84 GB found, sorted into safe to clean and check first" }, "pages": [ { "id": "xcode-deriveddata", "title": "Clear Xcode DerivedData", "capture": "../captures/xcode.png" } ], "ph": { "fromShots": "../store-screenshots/shots.json" }, "x": { "title": "A Mac cleaner for developers", "capture": "../captures/overview.png" } }pages、ph、xを省略すると、その種類をスキップします。パスはog.jsonからの相対パスです。ページはlinkからすべて(キャプチャ、クロップ、レイアウト)を継承し、指定したものを上書きします。link、ページ、スライド、xで使用できるオプション:capture(またはcaptures、最大3つまでスタック可能)、crop({ x, y, w, h }、透明マージンをトリミングした後のキャプチャの0から1の範囲。複数キャプチャの場合はcrops)、clean、square、radius、width(キャプチャ幅のカードに対する割合)、shadow: false、minCoverage。layout:リンクカードはside(タイトル左、ウィンドウは右下から立ち上がる)またはbelow(タイトル中央、その下に幅広キャプチャ)です。デフォルトは、キャプチャが2:1より広ければbelow、そうでなければsideを選択します。スライドはfit(キャプチャ全体、何もカットしない)、bleed(下端でカット、ウィンドウ用)、またはpair(2つまたは3つのキャプチャをスタック)です。layoutがなく、1つのプレーンなウィンドウキャプチャ(cleanなし)のスライドはbleedになります。それ以外はすべてfitです。minCoverage:UIカバレッジの最低値(リンク0.3、スライド0.4、ヘッダー0.12)。キャプチャがカード幅の80%を占める場合、これは不要です(薄いアイランドやバーはそれ以上高くなれません)。小さなキャプチャを隠すために最低値を下げないでください。大きく表示するか、クロップするか、別のキャプチャを選んでください。fromShotsのスライドで、"slides": [{ "id": "<shot id>", ... }]を追加すると、そのスライドのオプションを上書きできます。
背景はすべての画像で一度設定します。
"wallpaper": "auto"は、バンドルされた画像の中から、ブランドのアクセントカラーに最も近い色相のものを選び、その選択と理由を出力します。選択と理由、および変更可能であることをユーザーに伝えてください("wallpaper": "snow"、または自分で用意した明るく落ち着いた画像へのパス、少なくとも2400px幅)。グレーのアクセントカラー、またはすべての画像から50度以上離れているアクセントカラーの場合は、代わりにブランドフィールド(ブランドの背景をアクセントカラーで薄く染めたもの)を使用します。このキーを省略するとフィールドになります。このスキルは5つの画像をバンドルしています。 -
レンダリング。
node <skill-folder>/scripts/render.mjs launch-assets/og/og.jsonPNGごとに1行の出力:
okまたはFAIL、サイズ、ファイルサイズ、タイトルを実際に描画したフォント、単語の背後にある実際のピクセルとのコントラスト、タイトルのサイズとキャップハイト、UIカバレッジ、キャプチャと壁紙が拡大された倍率。--only link|pages|ph|xで1種類だけレンダリングします(それ以外は失敗します)。meta.htmlも書き出します。ガードは以下で失敗します:サイズが正確でない、アルファチャンネルがある、5MBを超える、テキストのコントラストが 4.5:1未満(スリムはありません。より薄い壁紙か濃いインクを選んでください)、タイトルのキャップハイトが最小値未満(リンク40px、スライド38px、ヘッダー36px。600px幅のプレビューでも読めるように)、収まる行数を超えている、長すぎるかダッシュ(" - " または "--")または
!が含まれるコピー、キャプチャが1.15倍以上に拡大されている、壁紙が1.2倍以上に拡大されている、UIカバレッジが最低値を下回っている(キャプチャがカード幅の80%を占める場合は除く。キャプチャのコンテンツピクセルで測定され、そのボックスではないため、空白の黒または白の領域はカウントされません)、Xセーフエリアの外側またはアバターゾーン内にあるもの、およびフォントのフォールバック:fonts.familyの最初に指定されたファミリーがタイトルを描画したフォントである必要があります(ファイルがない"Inter, sans-serif"はSF Proを描画するためFAIL)。-apple-systemまたはsystem-uiで始まるスタックはシステムフォントを意味し、HelveticaやArialなどのフォールバックでのみ失敗します。og.jsonのすべてのFAILを修正し、再度レンダリングしてください。 -
QAパス。必須。設定ではなくファイルに対して行います。
- サイズとアルファ:
sips -g pixelWidth -g pixelHeight -g hasAlpha <各ファイル>。sizes.mdの正確なサイズ、hasAlpha: no。 - 見た目: すべての PNG をReadツールでフルサイズで開きます。次に
node <skill-folder>/scripts/preview.mjs launch-assets/ogを実行し、_preview-600.pngと_preview-300.png(すべての画像を600px幅と300px幅で表示)を開き、その後2つのファイルを削除します。各画像について確認すること:- タイトルが300pxで読め、クリップされていたり、2行目に孤立していたりしない。
- 出力行のフォントが指定したものである。
- キャプチャがシャープで、タイトルのポイントを示しており、テキストが省略されておらず、個人データが含まれていない。
- 名前:競合他社や他社の名前、ロゴが含まれていない(サイトがその統合を挙げている場合を除く)。個人名が含まれていない。
- 言葉:すべての行がサイト自身の文言を短縮したものであり、すべての数字はサイト上にある。
- Xヘッダー:左下(x < 420、y > 300)がプロフィール写真のためにクリアであること。コンテンツは中央のバンドにあり、上下70pxから離れていること。sizes.mdと照合し、可能であれば実際のプロフィールでも確認すること。
- セット:スライドは1つのファミリーとして読めること。同じポイントを伝えるスライドが2つないこと。
- 修正して再度レンダリングし、そのファイルをもう一度見る。
- その後にのみ報告する: ファイルリスト、
sipsの出力、および確認できなかったこと。ユーザーに、PNGをサイトにコピーし、meta.htmlを<head>に貼り付け、各プラットフォームのデバッガーでキャッシュされたプレビューをリフレッシュするように伝えてください。
- サイズとアルファ:
見た目のルール
- まずライト。 明るい壁紙またはブランドフィールド。その上に暗いインク。暗い背景にネオンカラーは禁止。
- グローなし、ハローなし。 奥行きは1pxのエッジと、低不透明度のニュートラルな黒い影のみ。
- 画像ごとに1つの役割。 1つのタイトル、1つのキャプチャ(または1つのペア)、最大1つのサブライン。
- 大きなタイプ。 タイトルはサムネイルでも残るものです。短いコピーはそれを大きくするために必要です。
- 実際のキャプチャのみ。 UIは描画、再描画、生成されることはありません。