og-images
Installation
SKILL.md
OG images — per-page share cards
When a URL is shared (WhatsApp, Slack, iMessage, X, LinkedIn, Discord), the og:image
is the preview. Get it wrong and the link shares with no picture or a badly cropped
one — a silent conversion leak. This skill makes every page render a consistent,
on-brand 1200×630 JPEG ≤300 KB, generated by a committed script and enforced by the
test gate.
The three hard rules (messengers enforce them)
- 1200×630, exactly (1.91:1). Square images get cropped on X/Teams; off-ratio ones
letterbox. The starter's
Base.astroalready emitsog:image:width/height= 1200×630. - ≤300 KB. WhatsApp silently drops previews heavier than ~300 KB — the link then shares with no image at all. Encode JPEG and compress to fit.
- Extension matches the bytes. A PNG renamed
.jpgtrips strict scrapers. Use JPEG for photographic cards, PNG only for flat logo/gradient cards that still come ≤300 KB.