Skip to content
Back to search

og-images

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/abdiraimov-otabek--claude-code-og-image-skill/badge.svg)](/listings/abdiraimov-otabek--claude-code-og-image-skill)

HTML

<a href="/listings/abdiraimov-otabek--claude-code-og-image-skill"><img src="/api/listings/abdiraimov-otabek--claude-code-og-image-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

In Claude Code (2.1.275 or later):

/plugin install og-images --marketplace abdiraimov-otabek/claude-code-og-image-skill

On an older Claude Code: `/plugin marketplace add abdiraimov-otabek/claude-code-og-image-skill`, then `/plugin install og-images@og-images`.

Then open your app's repo and ask:

Make the link preview, Product Hunt gallery and X header for this app

On first use the skill installs Playwright 1.59.1 into its own folder, never your repo, to render the images.

<details> <summary>Install without the plugin system</summary>

git clone https://github.com/abdiraimov-otabek/claude-code-og-image-skill
ln -s "$PWD/claude-code-og-image-skill/skills/og-images" ~/.claude/skills/og-images

Then run `/reload-skills` in Claude Code. </details>

Requirements

- macOS with Claude Code - Node.js 20 or newer - Your app's icon and at least one real screen of the app, or a way to capture one (the skill looks for your app's own demo or snapshot mode first, and ships a one-line window capture for Mac apps)

It writes only to `launch-assets/og/` and `launch-assets/brand.json` in your repo.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 6 lines
  1. {
  2. "name": "og-images",
  3. "owner": { "name": "Otabek Abdiraimov", "url": "https://github.com/abdiraimov-otabek" },
  4. "metadata": { "description": "Link previews, a Product Hunt gallery and an X header from your app's real UI." },
  5. "plugins": [ { "name": "og-images", "source": "./", "description": "Link previews, a Product Hunt gallery and an X header from your app's real UI, checked on the files.", "version": "1.1.3" } ]
  6. }
README.md · README · 152 lines
  1. <div align="center">
  2. # og-images
  3. **Link previews that look like your app.**<br>
  4. A free Claude Code skill that makes your app's launch images from its real UI: the link preview, a Product Hunt
  5. gallery and an X header. Then it checks every file before it hands them to you.
  6. [![Claude Code plugin](https://img.shields.io/badge/Claude_Code-plugin-d97757?style=flat-square)](#install) [![License: MIT](https://img.shields.io/badge/license-MIT-2ea043?style=flat-square)](LICENSE) [![macOS](https://img.shields.io/badge/runs_on-macOS-2f2f2f?style=flat-square)](#requirements) [![GitHub stars](https://img.shields.io/github/stars/abdiraimov-otabek/claude-code-og-image-skill?style=flat-square&color=e3b341)](https://github.com/abdiraimov-otabek/claude-code-og-image-skill/stargazers)
  7. [Install](#install) · [What it makes](#what-it-makes) · [Before and after](#before-and-after) · [How it works](#how-it-works) · [FAQ](#faq)
  8. </div>
  9. ![og-images: link preview cards made for Halo and Shedi, two shipping Mac apps](docs/images/hero.jpg)
  10. ## Why
  11. Your link preview is the first thing people see of your app: in X, Slack, iMessage, Reddit and Product Hunt. Most
  12. indie apps ship a logo on a gradient, or nothing. og-images reads your repo and makes cards that show the real app,
  13. in your colours and your site's own words, at every size each platform asks for.
  14. ## Install
  15. In Claude Code (2.1.275 or later):
  16. ```
  17. /plugin install og-images --marketplace abdiraimov-otabek/claude-code-og-image-skill
  18. ```
  19. On an older Claude Code: `/plugin marketplace add abdiraimov-otabek/claude-code-og-image-skill`, then
  20. `/plugin install og-images@og-images`.
  21. Then open your app's repo and ask:
  22. ```
  23. Make the link preview, Product Hunt gallery and X header for this app
  24. ```
  25. On first use the skill installs Playwright 1.59.1 into its own folder, never your repo, to render the images.
  26. <details>
  27. <summary>Install without the plugin system</summary>
  28. ```bash
  29. git clone https://github.com/abdiraimov-otabek/claude-code-og-image-skill
  30. ln -s "$PWD/claude-code-og-image-skill/skills/og-images" ~/.claude/skills/og-images
  31. ```
  32. Then run `/reload-skills` in Claude Code.
  33. </details>
  34. ### Requirements
  35. - macOS with Claude Code
  36. - Node.js 20 or newer
  37. - Your app's icon and at least one real screen of the app, or a way to capture one (the skill looks for your app's own
  38. demo or snapshot mode first, and ships a one-line window capture for Mac apps)
  39. It writes only to `launch-assets/og/` and `launch-assets/brand.json` in your repo.
  40. ## What it makes
  41. | File | Size | What is in it |
  42. |---|---|---|
  43. | `og.png` | 1200×630 | Your icon and name, a large title that still reads at 300 px wide, a real capture, on your brand colours or a bright wallpaper |
  44. | `og-<page>.png` | 1200×630 | Optional: one per page of your site, titled from each page's own `<title>` or `<h1>` |
  45. | `ph/01…06.png` | 1270×760 | A Product Hunt gallery: slide 1 is the hero, each other slide one benefit |
  46. | `x-header.png` | 1500×500 | Your X header, with text kept clear of your profile photo and the phone crop |
  47. | `meta.html` | | The `og:image`, `twitter:card`, size and alt tags, ready to paste |
  48. Sizes are checked against Product Hunt's and X's own help pages, with dates, in
  49. [sizes.md](skills/og-images/references/sizes.md).
  50. ## Before and after
  51. | | Before: the site's own card | After: og-images |
  52. |---|---|---|
  53. | **Halo** | ![Halo's old link preview](skills/og-images/examples/halo-before.jpg) | ![Halo's new link preview made by og-images](skills/og-images/examples/halo-after.jpg) |
  54. | **Shedi** | ![Shedi's old link preview](skills/og-images/examples/shedi-before.jpg) | ![Shedi's new link preview made by og-images](skills/og-images/examples/shedi-after.jpg) |
  55. ### Product Hunt gallery
  56. ![Three Product Hunt gallery slides for Halo](docs/images/ph.jpg)
  57. ### X header, clear of your profile photo
  58. ![Halo's X header with the profile photo laid over it on desktop and phone, nothing covered](docs/images/x-avatar.jpg)
  59. The avatar zone was measured on x.com itself, on desktop and on a phone. The render fails if any text or UI lands in it.
  60. ## How it works
  61. 1. **Brand.** It reads your repo (README, site, asset catalog, `Info.plist`, CSS) and writes `launch-assets/brand.json`:
  62. name, one-liner, colours, fonts, icon. It asks you only for what it could not find.
  63. 2. **Real captures.** It uses your app's real screens, never drawn or generated UI: focused window, animations settled,
  64. neutral demo data.
  65. 3. **Your words.** Titles are your site's own sentences, shortened. Never paraphrased, never a number that is not on
  66. your site.
  67. 4. **Render.** HTML and CSS rendered by Playwright at the exact pixel size, the same bytes on every run.
  68. 5. **Check the files.** Every PNG is measured before you see it:
  69. - exact size and no alpha channel
  70. - text contrast of at least 4.5:1, on the real pixels behind the words
  71. - a minimum title size, so it reads in a feed at 600 px and as a 300 px thumbnail
  72. - the font that actually drew the text (a silent fallback to Helvetica or Times fails)
  73. - the X avatar zone and phone crop
  74. - how much of the card the app fills
  75. A failure stops the run with one clear line, and the skill fixes it before it reports.
  76. ## FAQ
  77. **Does my code leave my Mac?**<br>
  78. No. Everything renders locally. Claude Code reads your repo the same way it does for any other task.
  79. **Does it work for iPhone apps?**<br>
  80. The cards are built around landscape, Mac-style captures. For phone screenshots, see the App Store screenshot skill
  81. in Gold Master Kit below.
  82. **Can I use my own background?**<br>
  83. Yes. It picks one of five bright wallpapers to match your accent colour, or uses a soft field of your own brand colours,
  84. or any image you point it at.
  85. **What is inside?**
  86. ```
  87. skills/og-images/
  88. SKILL.md what Claude follows
  89. scripts/render.mjs renders the PNGs and runs the checks
  90. scripts/pages.mjs lists a site's pages with their title and h1
  91. scripts/preview.mjs contact sheet at 600 px and 300 px wide
  92. scripts/capture-window.swift captures one window of a running Mac app
  93. templates/og.html the card
  94. assets/wallpapers/ five bright landscapes, 1.8 MB in all
  95. references/sizes.md sizes and safe zones, with sources and dates
  96. ```
  97. ## Licence
  98. MIT, see [LICENSE](LICENSE). The five wallpapers have their own terms in
  99. [skills/og-images/assets/wallpapers/LICENSE-wallpapers.md](skills/og-images/assets/wallpapers/LICENSE-wallpapers.md):
  100. free to use in your own launch graphics, not to be resold or redistributed as a pack.
  101. ## From the author
  102. I'm Otabek, and I build and sell Mac apps on my own: [Halo](https://halo-mac.com) and [Shedi](https://shedi.app). The
  103. cards above are their real launch images. I also made the free
  104. [dashboard-design](https://github.com/abdiraimov-otabek/dashboard-design-skill) skill.
  105. og-images is one skill from **[Gold Master Kit](https://goldmasterkit.com)**, a paid pack for Mac and iOS launches. It
  106. adds App Store screenshots at Apple's exact sizes, launch posts, a launch film and a one-page website, each checked on
  107. the files.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.