Open Graph Audit Claude Skill
This skill audits a website's Open Graph and Twitter Card (social sharing) metadata and produces an actionable report on how the site's links render when shared. It crawls pages and probes each share image to find missing og:title, og:description, og:image, or og:url; broken, non-image, or relative og:image URLs; og:url that mismatches the canonical; missing twitter:card; over-length social titles and descriptions; and brand-default images reused across many pages.
Quick Take
Point the skill at a site root or URL list. It crawls pages, reads every Open Graph and Twitter Card tag, probes each share image, and returns a prioritized report of what's missing or broken in link previews.
What The Skill Checks
- Required tags: missing og:title, og:description, og:image, or og:url, and missing twitter:card.
- Image health: broken, non-image, or relative og:image and twitter:image URLs, and brand-default images reused across many pages.
- Consistency and length: og:url that mismatches the canonical, and over-length social titles and descriptions.
How The Skill Is Packaged
The skill follows the standard Claude Agent Skill structure: a SKILL.md file with YAML frontmatter and workflow instructions, a references/ folder with the full audit check definitions and report template, and a scripts/ folder with Python scripts that crawl the site and extract every Open Graph and Twitter Card tag, then probe each share image and audit the resulting inventory. Install it with npx claude-seo-skills install open-graph-audit, or copy the skill folder into your Claude skills directory; Claude invokes it automatically when a request matches its description.
Skill Files
Every file in the skill is embedded below directly from the Claude-SEO-Skills repository, so you can review exactly what the skill instructs Claude to do before installing it.
SKILL.md
The skill definition: frontmatter, inputs to collect, the workflow, and the resources the skill relies on.
Audit Checks Reference (references/audit-checks.md)
Full definitions, severities, and rationale for every check across the high, medium, and low tiers.
Report Template (references/report-template.md)
The output structure the skill follows, including the sections issues are grouped into.
Social Tag Extractor Script (scripts/extract_social.py)
Crawls pages and extracts every Open Graph (og:*) and Twitter Card (twitter:*) tag.
Social Tag Auditor Script (scripts/audit_social.py)
Probes each share image for status and content type, then runs the audit checks and outputs the structured report data.