open-graph-audit
Skill3 starsChanged 5 months agoMITView on GitHub
Audit a website's Open Graph and Twitter Card (social sharing) metadata for SEO and link previews. Crawls pages and probes each share image to find missing og:title, og:description, og:image, or og:url; broken or non-image or relative og:image URLs; og:url that mismatches the canonical; missing twitter:card; over-length social titles/descriptions; and brand-default images reused across many pages. Use when the user asks to audit, check, validate, or fix Open Graph tags, og: tags, Twitter Cards, social sharing previews, social metadata, or link preview images on a website.
- Installs packages
In this repository19 other files it gives its agents.
- canonical-tag-auditSkill
- content-quality-auditSkill
- core-web-vitals-auditSkill
- external-link-auditSkill
- full-seo-auditSkill
- heading-structure-auditSkill
- image-seo-auditSkill
- internal-link-auditSkill
- keyword-cannibalization-auditSkill
- llms-txt-auditSkill
- meta-data-auditSkill
- mixed-content-auditSkill
- pagination-auditSkill
- redirect-auditSkill
- robots-txt-auditSkill
- schema-markup-auditSkill
- site-architecture-auditSkill
- sitemap-auditSkill
- soft-404-auditSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 3 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 13
Use this skill when the user asks to:
- Very specific: line 69
Write a report following references/report-template.md: summary by severity, broken/missing images first, then completeness gaps, then a …
- Very specific: line 75
Missing/broken image: add or repair an absolute https:// og:image (1200×630 recommended) that returns 200.
- Distinctive: line 77
Missing og:title/description: add them (page title and meta description are good sources).
- Distinctive: line 80
Relative/non-image og:image: use an absolute URL to a real image file.
- Very specific: line 81
twitter:card: add summary_large_image for most content.
- Very specific: line 88
If the user wants the report as a .docx (for example, to share with stakeholders or attach to a ticket), save the Markdown report to a file …
- Very specific: line 98
If the user wants the raw findings as a spreadsheet (for filtering, sorting, or triage in Sheets or Excel), convert the audit's …
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Open Graph / Social Metadata Audit
Audit a website's Open Graph and Twitter Card tags and produce an actionable report on how the site's links render when shared.
When to use this skill
Use this skill when the user asks to:
- Audit, validate, or check Open Graph (
og:*) or Twitter Card (twitter:*) tags - Diagnose why links look wrong / have no image when shared on social or chat
- Find missing or broken share images, or
og:urlthat points at the wrong URL - Improve social click-through and link previews
Inputs to collect
- Site URL or URL list: a live site root to crawl (auto-seeds from
/sitemap.xml), or a text file with--url-list. - Scope: pages to crawl (default 500,
--max-pages). - Image probing: whether to probe each
og:image/twitter:imagefor status and content type (default on;--no-probeto skip).
Workflow
Step 1: Crawl and probe social tags
Use scripts/extract_social.py:
python3 scripts/extract_social.py https://example.com --max-pages 500 --output social_inventory.json
# already crawled once (e.g. in a full SEO audit)? skip the crawl and reuse the shared cache:
# python3 scripts/fetch_pages.py https://example.com --output page_cache.json
# python3 scripts/extract_social.py --from-cache page_cache.json --output social_inventory.jsonIt records each page's OG and Twitter Card tags, canonical, and meta robots, then probes each unique share image for HTTP status and content type.
Step 2: Run the audit checks
python3 scripts/audit_social.py social_inventory.json --output audit_report.jsonStep 3: Evaluate the audit checks
Evaluate each check in references/audit-checks.md. Core checks:
| Check | Severity |
| Missing og:title | High |
| Missing og:image | High |
| Broken og:image (non-200) | High |
| Missing og:description | Medium |
| Missing og:url | Medium |
| og:url mismatches canonical | Medium |
| og:image not an image / relative | Medium |
| Missing twitter:card (no OG fallback) | Low |
| og:title / og:description too long | Low |
| Duplicate/default share image across many pages | Info |
Step 4: Produce the report
Write a report following references/report-template.md: summary by severity,
broken/missing images first, then completeness gaps, then a prioritized action
list.
Step 5: Recommend fixes
- Missing/broken image: add or repair an absolute
https://og:image(1200×630 recommended) that returns200. - Missing og:title/description: add them (page title and meta description are good sources).
- og:url missing/mismatched: set it to the canonical absolute URL.
- Relative/non-image og:image: use an absolute URL to a real image file.
- twitter:card: add
summary_large_imagefor most content. - Base every recommendation on observed data; never assume an image loads.
Optional: export the report
As a Word document (.docx)
If the user wants the report as a .docx (for example, to share with stakeholders or attach to a ticket), save the Markdown report to a file and convert it:
python3 scripts/md_to_docx.py report.md --output report.docxscripts/md_to_docx.py uses only the Python standard library (no pip install) and renders headings, tables, lists, links, bold/italic, and code blocks. Offer this whenever a user asks for a Word doc, a .docx, or a shareable/downloadable report.
As a CSV of findings (.csv)
If the user wants the raw findings as a spreadsheet (for filtering, sorting, or triage in Sheets or Excel), convert the audit's audit_report.json directly:
python3 scripts/findings_to_csv.py audit_report.json --output findings.csvscripts/findings_to_csv.py is also standard-library only. It writes one row per finding, with check and severity columns prepended and list fields (e.g. the pages sharing a duplicate value) joined with ; . Unlike the .docx, which reformats the written report, the CSV is a direct dump of the structured findings: offer it whenever a user wants the data itself, a spreadsheet, or to slice findings by check or severity.
Resources
scripts/md_to_docx.py: convert the Markdown report into a Word (.docx) document (standard library only)scripts/findings_to_csv.py: flatten the audit findings JSON into a CSV, one row per finding (standard library only)references/audit-checks.md: full definitions, thresholds, and rationalereferences/report-template.md: report output structurescripts/extract_social.py: crawl pages and probe share imagesscripts/audit_social.py: run audit checks against the inventory
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

