Community图像github.com

og-images

从真实应用界面生成启动图:1200×630 的链接预览(Open Graph 和 X 卡片)、Product Hunt 画廊、X 头图以及相应的元标签。

og-images 是什么?

这个技能为开发者的应用生成高质量的社交分享图片,涵盖 Open Graph 链接预览(1200×630,包含大号可读标题、应用图标和真实界面截图)、Product Hunt 画廊(4 到 6 张 1270×760 的幻灯片)以及 X(原 Twitter)头图(1500×500,确保头像和手机裁剪区域不被遮挡)。它从实际的应用 UI 截图入手,而不是手动绘制,让预览图真正体现产品的核心功能。同时支持可选的每页预览,适用于有多个页面的网站。所有输出文件都会经过严格的质量检查:精确尺寸、无 Alpha 通道、文本对比度(至少 4.5:1)、标题大小、安全区域以及字体回退检测,确保图片在所有平台(Open Graph 调试器、X 卡片验证器、Product Hunt 上传)上都能正常显示。技能还会自动生成要粘贴到 `<head>` 中的 `<meta>` 标签。该技能适用于 Claude Code 等 AI 代理,但也兼容 Cursor、Codex 等支持自定义技能的开发工具与平台。

兼容平台~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 图像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

OG 图片

三种图片,共同完成一个任务:让用户在链接上停下来,并在一瞥之间理解这个应用。 每一张都是应用的真实截图,配以大号标题,背景使用品牌色或明亮的壁纸。UI 才是主角。除了边框,一切都不是画出来的。

输出文件位于用户仓库的 launch-assets/og/ 目录:

文件尺寸用途
og.png1200×630首页的链接预览。
og-<id>.png1200×630可选:网站每个页面一张,设计相同,标题来自对应页面。
ph/01-<id>.png … 061270×760Product Hunt 画廊,4 到 6 张幻灯片。幻灯片 1 为主视觉。
x-header.png1500×500X 头图,头像和手机裁剪区域保持清晰。
meta.html要粘贴到 <head> 中的 <meta> 标签。

尺寸和安全区域等详细信息,请参考 references/sizes.md。

何时使用

  • 发布时需要分享图片、Product Hunt 画廊或 X 头图。
  • 网站当前的 og:image 只是一个纯色背景上的 logo,或者根本就没有。
  • 发布新版本改变了 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。如果存在,直接使用。如果缺失,从仓库中检测各个字段并写入文件。仅就你无法找到的信息,在一条消息中询问用户。

{
  "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 定义中获取。取浅色模式的值。写入十六进制表示(#0d7f76);先转换 rgb()、oklch() 和 hsl()。任何渲染器无法读取的颜色都视为灰色。
  • fonts.family(CSS 字体堆叠)、fonts.file(仓库自带的字体文件,相对于仓库根目录的路径,即 launch-assets 的上一级目录,或者 null)、fonts.google(例如 Geist:wght@400;600,或者 null)。仅当仓库自带字体文件时才使用品牌字体;否则使用系统堆叠或 Google 字体。切勿将专有字体复制到用户仓库中。
  • iconPath:应用图标,一个方形 PNG(最佳为 1024 像素),相对于仓库根目录。在网站资源、素材目录的 AppIcon、favicon 文件夹中查找。必需的:图标和名称出现在每张图片上。
  • siteUrl:meta.html 中图片 URL 的指向。可选;没有它,标签将包含占位符。

步骤

  1. 截图。 重复使用已有的内容: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)。在运行之前阅读标志的说明。切勿运行任何扫描、清理或写入真实用户数据的操作,也切勿启动第二个会保留实时状态的应用副本。 如果某个标志可能执行此类操作,立即停止并询问。否则,在 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 倍(超过此值渲染失败),因此链接预览需要窗口宽度约 1400 像素,画廊幻灯片需要约 2000 像素。
    • 真实内容。 没有空白的占位区域,没有 lorem ipsum,标题所涉及的部分没有截断的文本。
    • 小尺寸下可读。 链接预览中截图的显示宽度约为 600 像素。选择在该尺寸下主要元素可见的截图(如一个大数字、一个清晰的列表),而不是密集的设置面板。裁剪到关键区域。
    • 若使用 SwiftUI ImageRenderer 捕获(例如刘海应用的悬浮岛),其边角闪光处会带有不透明的黄色占位符:设置 "clean": true。若悬浮岛浮在卡片上,添加 "square": true,将其边角闪光处向卡片边缘拉直为方形。使用 crop 裁剪掉任何空白的刘海行。

    当每张截图都通过规则检查后完成。读取每个文件的尺寸(sips -g pixelWidth -g pixelHeight)并检查其内容。

  2. 撰写文字。

    • 链接标题: 应用的一句话介绍或页面自身的标题,使用网站的原话:不超过 9 个单词,采用句子大小写,不加句号、破折号或 !。这是卡片上唯一的较大文字,因此更短的文字可以更大。
    • 页面: 如果仓库有包含多个页面的网站,运行 node <skill-folder>/scripts/pages.mjs <site-folder>。它会打印每个页面的 <title> 和 <h1>。选择值得为其制作独立预览的页面(如指南、定价页、主要功能页);跳过会提到其他公司产品名称的页面。使用 <h1> 或两者中较短的一个,去掉网站名称后缀和类似“(2026)”的标签,保持不超过 9 个单词。切勿改写。
    • 幻灯片: 如果 launch-assets/store-screenshots/shots.json 存在,"ph": { "fromShots": "../store-screenshots/shots.json" } 会复用其标题、副标题、截图和裁剪(前 6 张截图,"limit" 可更改此数量)。否则撰写 4 到 6 张幻灯片:幻灯片 1 说明应用是什么,以后的每张幻灯片叙述一个优势并可以独立理解。标题不超过 6 个单词,可选的副标题为一句短句。
    • X 头图标题: 应用的一句话介绍。不超过 6 个单词。
    • 替代文本: 一句话说明图片显示的内容。默认格式为 <应用名>: <标题>. <副标题>;当截图有值得说明的内容时,在链接上编写 alt 属性。

    文案使用网站自己的用语。 每一行文字都取自网站或 README 并被缩短;每一个数字、名称和声明都在网站上。在保留每一行之前,使用 rg 与网站文案进行核对。

  3. 编写 launch-assets/og/og.json。

    {
      "brand": "../brand.json",
      "out": ".",
      "wallpaper": "auto",
      "link": {
        "title": "为开发者打造的 Mac 清理工具",
        "capture": "../captures/overview.png",
        "alt": "Shedi,一款为开发者打造的 Mac 清理工具:发现 43.84 GB 可清理空间,已分类为安全清理和需检查项"
      },
      "pages": [
        { "id": "xcode-deriveddata", "title": "清除 Xcode DerivedData", "capture": "../captures/xcode.png" }
      ],
      "ph": { "fromShots": "../store-screenshots/shots.json" },
      "x": { "title": "为开发者打造的 Mac 清理工具", "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、且只有一张普通窗口截图(无 clean)的幻灯片,使用 bleed;其他情况使用 fit。
    • minCoverage:UI 覆盖度的最低要求(链接 0.3,幻灯片 0.4,头图 0.12)。如果截图宽度占卡片宽度的 80% 以上,则无需此条件(细长的悬浮岛或条状元素无法变得更高)。不要为了掩盖小截图而降低此下限:应放大显示、裁剪或选择其他截图。
    • 在 fromShots 的幻灯片中,添加 "slides": [{ "id": "<截图 id>", ... }] 以覆盖某一张幻灯片的选项。

    背景,一次性应用于所有图片:"wallpaper": "auto" 会选择色调最接近品牌强调色(蓝色和青色、绿色、暖色、粉色)的捆绑图片,并打印选择结果及原因。向用户告知选择结果和原因,以及他们可以更改此设置("wallpaper": "snow",或指向他们自己明亮的、平静的图片的路径,宽度至少 2400 像素)。灰色强调色,或与所有图片色调相差超过 50 度的强调色,则使用品牌纯色背景(在品牌背景色上混合少量强调色)。省略此键则使用纯色背景。此技能捆绑了五张图片。

  4. 渲染。

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

    每张 PNG 输出一行:ok 或 FAIL、尺寸、文件大小、实际用于绘制标题的字体、文字与其背后像素的对比度、标题的大小和 cap 高度、UI 覆盖度以及截图和壁纸的放大倍数。--only link|pages|ph|x 仅渲染一种类型(其他参数失败)。同时写入 meta.html。

    检查失败的情况包括:尺寸不正确、含有 Alpha 通道、文件超过 5 MB、文字对比度低于 4.5:1(不用遮罩层;选择更浅的壁纸或更深的文字颜色)、标题的 cap 高度低于最小值(链接 40 px,幻灯片 38 px,头图 36 px,以便在 600 像素宽的预览中仍然可读)或超过可容纳的行数、包含过长或含破折号(“ - ”或“--”)或 ! 的文案、截图放大超过 1.15 倍或壁纸放大超过 1.2 倍、UI 覆盖度低于下限(除非截图宽度占卡片宽度的 80% 以上,以截图的内容像素而非边框衡量,因此纯黑或纯白区域不计入)、任何部分超出 X 安全区域或位于头像区域内,以及字体回退:fonts.family 中第一个命名字体系列必须是实际绘制标题的字体("Inter, sans-serif" 但无字体文件时实际将使用 SF Pro:FAIL)。以 -apple-system 或 system-ui 开头的堆叠表示使用系统字体,仅在回退到如 Helvetica 或 Arial 等其他字体时才判定为失败。修正 og.json 中的每一个 FAIL 并重新渲染。

  5. QA 检查。必需,且针对文件而非配置进行。

    1. 尺寸和 Alpha 通道: sips -g pixelWidth -g pixelHeight -g hasAlpha <每个文件>。尺寸必须严格符合 sizes.md 中的规定,hasAlpha: no。
    2. 查看: 使用“读取”工具以原尺寸打开每张 PNG。然后运行 node <skill-folder>/scripts/preview.mjs launch-assets/og,并打开 _preview-600.png 和 _preview-300.png(每张图片分别以 600 和 300 像素宽度显示,类似信息流中的展示效果),然后删除这两个文件。对每张图片检查:
      • 标题在 300 像素宽度下可读,没有内容被裁剪或单独出现在第二行。
      • 输出行中的字体是你指定的字体。
      • 截图清晰,显示了标题所针对的要点,没有截断的文字和个人数据。
      • 名称:没有竞争对手或其他公司的名称或 logo,除非网站提到了该集成;没有个人姓名。
      • 文字:每一行都是网站自己的措辞,经过缩短;每一个数字都来自网站。
      • X 头图:左下角(x 小于 420,y 大于 300)为个人资料照片保持空白;内容位于中间区域,远离顶部和底部各 70 像素的区域。对照 sizes.md 进行检查,如果可能,在真实个人资料页上查看。
      • 系列:所有幻灯片看起来属于同一系列;没有两张表达相同要点。
    3. 修改并重新渲染,然后再次查看该文件。
    4. 只有在此之后才报告:文件列表、sips 输出结果以及任何你无法验证的内容。告知用户将 PNG 复制到网站,将 meta.html 粘贴到 <head> 中,并在每个平台的调试器中刷新缓存的预览。

外观规则

  • 优先浅色。 使用明亮的壁纸或品牌纯色背景,深色文字放在其上。不要使用深色背景配霓虹色。
  • 无发光,无光晕。 深度效果仅为 1 像素边框和低透明度的中性黑色阴影。
  • 每张图片一个任务。 一个标题,一张截图(或一组对比图),最多一行副标题。
  • 大号字体。 标题是在缩略图中能够存活下来的元素。短文案才能让标题足够大。
  • 仅使用真实截图。 UI 绝不通过绘画、重绘或生成的方式制作。

相关技能