generate-og-images

name	generate-og-images
description	Use to generate branded 1200x630 social-share (OG/Twitter) card images for a site's pages, with title/tags/brand overlaid by Pillow over an AI, image, or gradient background. Triggers "make an OG image", "social card", "regenerate the share image". Generic to any Hugo-style content tree.

Generate social-share (OG) card images

Run when adding a post/talk, after changing a page's title or tags, or to generate the site-wide default card.

Workflow

python3 <skill-dir>/gen-og-image.py \
  --brand my.site --author "Full Name" \
  --subtitle "Topic A · Topic B" \
  --sections posts,talks \
  path/to/content/<slug>/index.md

• Targets are markdown files or bundle dirs; or --all-content; or --default for the site card.
• --brand / --author / --subtitle overlay text (no defaults — pass them).
• --bg FILE / --bg-dir DIR supply backgrounds; --print-prompts emits per-item AI prompts to paste into an image tool; absent → gradient.
• GEMINI_API_KEY (paid tier) enables AI backgrounds.

Guardrails

• Output is a 1200×630 PNG; place it where the site's OG templates resolve it (bundle feature.png, or static/og/...).
• Don't embed the card in the page body — it's a social asset only.

Output

One PNG per target.