What it does
Drafts og:title and og:description text tuned for how a link preview actually renders (shorter than a search snippet, more conversational), and checks whether the featured image works as an og:image at typical social crop ratios. Covers Twitter/X card fields separately when they differ from the Open Graph defaults.
Install
This skill isn't packaged in an installable registry. It's a plain SKILL.md file you can copy directly. Copy it from the SKILL.md tab and save it at the path for your assistant:
Use it in your AI assistant
Claude Code
.claude/skills/social-preview-copywriter/ (or ~/.claude/skills/social-preview-copywriter/ for all projects)
GitHub Copilot (VS Code)
.github/skills/social-preview-copywriter/
OpenAI Codex
.codex/skills/social-preview-copywriter/
Cursor
.cursor/skills/social-preview-copywriter/ (or ~/.cursor/skills/social-preview-copywriter/ globally)
Compatibility
Any WordPress site. Open Graph fields are written through the active SEO plugin (Yoast, Rank Math, SEOPress) or theme social meta settings if no SEO plugin is active.
The complete SKILL.md for this skill:
---
name: social-preview-copywriter
description: Use when a user wants Open Graph or social share preview copy written or fixed for a WordPress post or page. Triggers on "Open Graph", "social preview", "how this looks when shared", or "Twitter card".
---
# Social Preview Copywriter
## When to use
The user wants the link preview that appears when a post is shared on social platforms (title, description, image) written or improved, distinct from the search-engine meta title and description.
## Procedure
1. Read the post's content and existing SEO title/meta description as a starting point, but don't just copy them, social preview copy can be more conversational and can spoil the payoff differently than a search snippet should.
2. Draft an og:title (short, can differ from the SEO title) and og:description (1-2 sentences, gives a reason to click rather than a summary that removes the need to click).
3. Check the featured image against common social crop ratios and flag if faces, text, or key details sit near the edges where they'd get cropped.
4. Draft Twitter/X card copy separately only if the platform's card type or length limits genuinely differ from the Open Graph defaults.
5. Write the approved copy into the SEO plugin's social/Open Graph fields for that post.
## Guardrails
- Don't write preview copy that overpromises relative to the actual article, mismatched expectations show up as high bounce from social traffic.
- Flag if the featured image is missing or too low-resolution for social crops rather than letting a broken preview ship silently.