og-images SKILL.md skillA

og-images from karero/croftweaver is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add karero/croftweaver/og-images@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
karero/croftweaver
Path
skills/og-images/SKILL.md
Versions recorded
5
Latest version
v1.0.0, committed Jul 9, 2026
First version recorded
Jun 20, 2026
Size
6,784 bytes
Repository stars
8
License
MIT

Generate branded per-page Open Graph (social share) cards for a website: a 1200×630 JPEG ≤300 KB for every page, rendered by a committed Python+Pillow script and wired so each page sets its own `image=` (with a default fallback) and the test suite proves the card exists at the right size. Use when building or auditing a site's share previews — "OG image", "og:image", "social share image", "share card", "WhatsApp/Slack/LinkedIn preview", "Twitter card image…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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)

1. **1200×630, exactly** (1.91:1). Square images get cropped on X/Teams; off-ratio ones
   letterbox. The starter's `Base.astro` already emits `og:image:width/height` = 1200×630.
2. **≤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.
3. **Extension matches the bytes.** A PNG renamed `.jpg` trips strict scrapers. Use JPEG
   for photographic cards, PNG only for flat logo/gradient cards that still come ≤300 KB.

## How it's wired in the Astro starter

- **`scripts/generate_og_cards.py`** — the generator. Renders one card per page you list,
  plus a `default.jpg`. Run it with **`npm run og`**. Idempotent; commit the output.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add karero/croftweaver/og-images@sha256:3db04b919fa705ea

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_degbu4ktt3zuwuq6.svg)](https://markdownregistry.com/a/art_degbu4ktt3zuwuq6)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jun 20, 2026 and Jul 9, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-07-09 85a2747 6,784 BA view · diff
v1.0.02026-07-09 fe3a67e 6,601 BA view · diff
v1.0.02026-06-20 386c3d6 5,843 BA view · diff
v1.0.02026-06-20 df09428 5,555 BA view · diff
v1.0.02026-06-20 1d83cb8 5,354 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6784 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

karero/croftweaver · 8 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_degbu4ktt3zuwuq6
GET https://markdownregistry.com/api/v1/resolve?ref=karero/croftweaver/og-images
GET https://markdownregistry.com/api/v1/blob/3db04b919fa705ea1db96faf72d20afd597250f6a506f6fda538e689d2d2c383

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from karero/croftweaver

ai-seo SKILL.md skill
karero/croftweaver · skills/ai-seo/SKILL.md · When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers…
v1.2.0 · audit A · 8 stars
astro-i18n-setup SKILL.md skill
karero/croftweaver · skills/astro-i18n-setup/SKILL.md · Turn a new-website scaffold into a turnkey multi-language site: Astro i18n routing (clean default locale + prefixed…
git:20261008.0b58772 · audit A · 8 stars
business-listings-setup SKILL.md skill
karero/croftweaver · skills/business-listings-setup/SKILL.md · Post-launch: claim Google Business Profile, Bing Places, and category directories, then verify the `sameAs` profiles…
git:20260828.45295fb · audit A · 8 stars
copywriting SKILL.md skill
karero/croftweaver · skills/copywriting/SKILL.md · When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages…
v1.1.0 · audit A · 8 stars
customer-research SKILL.md skill
karero/croftweaver · skills/customer-research/SKILL.md · When the user wants to conduct, analyze, or synthesize customer research. Use when the user mentions "customer…
v1.0.0 · audit A · 8 stars
double-knuth SKILL.md skill
karero/croftweaver · skills/double-knuth/SKILL.md · Generic two-pass "Double-Knuth" review for ANY repo or file set: Pass 1 = correctness/bugs on the change (delegates to…
git:20260702.17487d7 · audit A · 8 stars
facts-check SKILL.md skill
karero/croftweaver · skills/facts-check/SKILL.md · Read-only consistency check of any live site, on any stack. FACTS: one approved facts list (value, source, owner)…
git:20261014.7cb141a · audit A · 8 stars
image SKILL.md skill
karero/croftweaver · skills/image/SKILL.md · When the user wants to create, generate, edit, or optimize images for marketing — blog heroes, social graphics, product…
v1.0.0 · audit A · 8 stars
independent-review SKILL.md skill
karero/croftweaver · skills/independent-review/SKILL.md · Domain-agnostic cross-model review gate: run a planning markdown (PLAN gate) or a branch/PR diff (DIFF gate) through…
git:20261020.9205219 · audit A · 8 stars
internal-link-audit SKILL.md skill
karero/croftweaver · skills/internal-link-audit/SKILL.md · Internal-linking tool for an Astro site built with the new-website kit. Builds the site's inbound-link graph from dist/…
git:20260829.3bef4bd · audit A · 8 stars
keystatic-setup SKILL.md skill
karero/croftweaver · skills/keystatic-setup/SKILL.md · Add Keystatic — a git-based CMS from the Keystone team — to a new-website Astro scaffold, so a non-technical person can…
git:20260716.5f5e7ec · audit A · 8 stars
new-website SKILL.md skill
karero/croftweaver · skills/new-website/SKILL.md · Orchestrates building a NEW website end-to-end, from insights to launch-ready and handoff-ready. Self-contained: it…
git:20261020.5c900a0 · audit A · 8 stars

Every file in karero/croftweaver

Browse by kind, by grade A, or by owner.