github-social

Installation
SKILL.md

GitHub Social Preview

Create a 1280x640 PNG social preview for a GitHub repository, using repository-open-graph-template.png (in this skill's folder) as the safe-area reference.

Workflow

  1. Gather repo signal from the request and local files: repo name, owner/org, README tagline, logo or mark, brand colors, primary language, and audience. Done when every bracket in the prompt template can be filled.
  2. Draft the prompt from the template below and generate with the built-in image tool, targeting gpt-image-2 where a model can be chosen — credentials are never needed, so proceed without asking for an API key. Pass repository-open-graph-template.png as a reference image when the tool accepts reference inputs; otherwise rely on the template's written safe-area constraint.
  3. Inspect the result at full size and at roughly 320x160. Regenerate or edit until every check passes: repo name spelled correctly and readable at thumbnail size, all critical content inside the safe area, no guide lines, template copy, watermarks, or unintended logos, and the visual matches the repository's actual purpose and tone.
  4. Save to assets/github-social-preview.png, creating assets/ if needed, unless the user names another path or that name collides with a file they want preserved.
  5. Link the image at the very top of README.md with a relative Markdown image link — before any badges or logo — unless the user opts out or asks for different placement. Repoint or replace an existing preview block instead of adding a second. If README.md does not exist, ask before creating one.
![Repository social preview](assets/github-social-preview.png)

Specs

Installs
39
GitHub Stars
1
First Seen
Jun 7, 2026
github-social — scottwater/skills