morluto / generate-social-preview

# Generate Social Preview
A reusable agent skill for creating social preview images grounded in what a
repository actually does. It reads the project, shapes concise copy, and
produces a card that stays readable at thumbnail size.
Use it for GitHub repository previews, package pages, launch posts, and link
cards for skills, libraries, developer tools, SaaS products, and other projects.
It supports new images, revisions, palette variants, and adapting a supplied
style reference.
## Install
Install for Cursor, Claude Code, Codex, GitHub Copilot, Gemini CLI, Cline,
Windsurf, Amp, and other supported agents with the
Skills CLI:
 [code] 
In Claude Code, you can use the plugin marketplace for the skill's slash
command and update management:
 [code] 
After installation, invoke `/generate-social-preview:generate-social-preview`.
For automatic updates, open `/plugin`, select the marketplace under
**Marketplaces**, and choose **Enable auto-update**. Choose one installation
method per agent to avoid duplicate copies.
The Skills CLI requires Node.js and npm. Select your agent in the installer,
or pass `--agent claude-code`, for example. Add `--global` for a user-wide
installation.
In Codex, install through its native plugin marketplace:
 [code] 
Start a new Codex session after installation and invoke
`$generate-social-preview:generate-social-preview`.
## Image tools
Use whatever image-generation and editing tools are available in your agent.
The skill works with the host's tools, APIs, CLIs, or installed image skills.
Use image viewing to inspect references and results. If generation is
unavailable, the agent can still prepare the copy, reference choices, and a
generation prompt.
The optional normalization helper needs Bash and either macOS `sips` or
ImageMagick's `magick` command.
## Use
Open the repository you want to feature and ask your agent:
 [code] 
You can provide a direction or constrain a revision:
 [code] 
 [code] 
By default, the skill produces one candidate, checks the copy and composition,
and saves a versioned image without overwriting an existing asset. GitHub
previews are normalized to a 1280×640 PNG after visual inspection.
## How it uses project references
Ground the imagery in the project, then choose the composition.
1. **Find relevant material.** Follow image links in the README and docs, and
 inspect screenshots, illustrations, demos, example outputs, and brand assets
 in the repository.
2. **Use what fits.** Pass useful images to the generator as project references,
 drawing on recognizable details, outputs, or brand cues. Existing material
 earns its place by helping communicate the project.
3. **Develop an idea when needed.** If existing images do not fit, build a visual
 idea from the project's purpose, examples, or domain. A skill, library, and
 SaaS product may each call for a different approach.
Project references inform what the preview shows; style references inform how
it looks. The composition can be a single image, typograp