repo-social-previewlisted

<!-- Author: jamestexas — drafted by claude-opus-4-7 (2026-05-16) --> # /repo-social-preview — GitHub Social Preview (OpenGraph) Audit a GitHub repository's social preview image — the 1280×640 card shown when the repo URL is unfurled on HN, Twitter, Slack, Discord, or any OpenGraph-aware surface. ## Arguments `$ARGUMENTS` - **`<owner/repo>`** — one or more target repos. Defaults to the repo containing the current working directory. - **`--audit-only`** *(default)* — report state and recommendations; no writes. ## Why this skill is audit-only GitHub's API **does not support uploading social preview images via REST**. The image must be uploaded through the web UI: > *Settings → General → Social preview → Edit → Upload an image* This skill therefore **does not apply changes**. It produces: 1. An inventory of which repos are missing previews (or have a stale auto-generated one). 2. Concrete recommendations for what image to upload. 3. The manual upload URL for each repo, so you can click through quickly. ## What this solves When someone posts your repo link to HN, Slack, or Twitter, the recipient sees one of three things: 1. **Custom social preview** (good) — a designed card that reinforces what the project is. 2. **GitHub's auto-generated card** (mediocre) — the repo name + description on a grey background. Better than nothing, but every repo on GitHub looks the same. 3. **No preview** (bad) — happens for some surfaces when the OpenGraph fetch fails. Just a bare lin