schema-markup
Skill0 starsChanged yesterdayMITView on GitHub
Check a page's structured data and write correct JSON-LD for its page type, validated against the properties Google requires for rich results. Use when the user asks for schema markup, structured data, JSON-LD, schema.org, rich results, rich snippets, review stars, FAQ schema, Product, Article, Organization, LocalBusiness, Breadcrumb, Event, Recipe, Video or JobPosting markup, 'add schema to my page', 'validate my schema', 'why are my rich results not showing', or a structured data error from Search Console.
67 other projects use a version of this.
Adopted by
Most recently taken up by
- Ivan-propio/claude-skillstheir own version, first seen Nov 16, 2026
- AlejandroGodius/claude-skillstheir own version, first seen Nov 16, 2026
- yotamwiesel/claude-skillstheir own version, first seen Nov 16, 2026
- harborrank/harborrank-skillstheir own version, first seen Nov 16, 2026
- RomeoSEO/seo-skillstheir own version, first seen Nov 15, 2026
- oivanfelipe/claude-skillstheir own version, first seen Nov 8, 2026
Used with
Projects with it also use internal-link-audit, product-marketing-context and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
semrushSkillinternal-link-audit
Audit internal linking to find orphan pages, broken internal links, crawl-depth problems, and weak anchor distribution, then plan the hub-and-spoke structure that fixes them. Use when the user asks about internal links, orphan pages, site architecture, crawl depth, or how to pass authority to priority pages.
Also in 3 projects that use this
xfstudioSkillproduct-marketing-context
When the user wants to create or update their product marketing context document. Also use when the user mentions 'product context,' 'marketing context,' 'set up context,' 'positioning,' or wants to avoid repeating foundational information across marketing tasks. Creates `.claude/product-marketing-context.md` that other marketing skills reference.
Also in 19 projects that use this
LangChainSkillcontent-brief
Turn a vague or multi-asset design ask into a brief. Pull what is already known, ask at most two questions with reasons, decide the rest and say what you decided.
Also in 5 projects that use this
ukunal91appSkillrevops
When the user wants help with revenue operations, lead lifecycle management, or marketing-to-sales handoff processes. Also use when the user mentions 'RevOps,' 'revenue operations,' 'lead scoring,' 'lead routing,' 'MQL,' 'SQL,' 'pipeline stages,' 'deal desk,' 'CRM automation,' 'marketing-to-sales handoff,' 'data hygiene,' 'leads aren't getting to sales,' 'pipeline management,' 'lead qualification,' or 'when should marketing hand off to sales.' Use this for anything involving the systems and processes that connect marketing to revenue. For cold outreach emails, see cold-email. For email drip campaigns, see email-sequence. For pricing decisions, see pricing-strategy.
Also in 14 projects that use this
VercelSkillsite-architecture
Use when planning or restructuring what pages a site has and how they connect: hierarchy, navigation, URL patterns, breadcrumbs, and internal linking. Not for XML sitemaps, which are in seo-audit.
Also in 16 projects that use this
alaraakcasizSkilltechnical-seo-audit
Technical and on-page SEO audit of any website — a client site, your own site, a competitor, or a staging build before a CMS migration. Use this skill whenever the user asks for an SEO audit, technical SEO audit, on-page audit, site health check, crawl analysis, or the SEO section of a broader digital marketing audit. Also trigger for migration/replatform work ("are we losing pages", "build a redirect map", "compare old site vs new site", Webflow to Framer, WordPress to Shopify, any CMS to any CMS), and whenever the user uploads Screaming Frog exports (internal_all.csv, image_details.csv, All Inlinks), a GSC Pages export, or a sitemap and wants them analysed. Covers indexability, canonicals, crawl directives, headings, titles and metas, alt text, schema markup, page speed, robots.txt, llms.txt, internal linking, page-inventory diffing and redirect mapping.
Also in 3 projects that use this
Other versions67 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 67
- TheCraigHewitt/seomachine★ 7.5ksame name
- LeoYeAI/openclaw-marketing-skills★ 1ksame name
- OpenClaudia/openclaudia-skills★ 731same name
- boraoztunc/skills★ 473same name
- mysticaltech/marketingskills★ 352same name
- textura-agency/next16-claude-starter★ 141same name
- b1rdmania/ghostclaw★ 91same name
- akii-technologies-ltd/akii-seo-ai-search-optimizer★ 80same name
- robertbstillwell/marketing-skills★ 26same name
- ukunal91app/Marketing-Skills-by-Corey-Haines★ 26same name
57 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository6 other files it gives its agents.
- ai-search-visibilitySkill
- broken-linksSkill
- on-page-seoSkill
- seo-auditSkill
- site-migration-checkSkill
- technical-seoSkill
The file
We split this skill into the rules it gives an agent
3 rules. 0 are common, 1 is distinctive, and 2 are very specific to this project.
0
Common
Most of the 66 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 12
Look for the Crawl Cove crawl tools: names ending in crawl_site, get_page, list_pages.
- Very specific: line 25
Inventory existing markup: every JSON-LD block, plus any microdata (itemscope) or RDFa.
- Distinctive: line 35
Markup must match visible content: Do not mark up reviews, prices, FAQs or authors that a visitor cannot see on that page.
“Common” is measured: kept by at least 6 in 10 of the 66 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Schema markup: check it and write it
Structured data does two things: it makes a page eligible for specific rich results in Google, and it states plainly what the page's entities are. It is not a ranking boost. Write markup only for content that is visible on the page, in the types Google acts on, with every required property present.
Step 0: which mode are you in, and what the crawl tools can do here
Look for the Crawl Cove crawl tools: names ending in crawl_site, get_page, list_pages.
The crawl tools do not extract JSON-LD. Their job in this skill is to find the pages and templates that need markup. Reading a page's existing markup always needs the page's HTML: fetch it with your web fetch tool or a shell, or ask the user to paste the page source.
- Crawl mode (tools present): you can survey the site's page types, then fetch representatives.
- Page mode (tools absent, as in claude.ai chat): work on the page or pages the user gives you. Say you have seen N pages and cannot speak for the rest of the site.
Procedure
- Establish the page type. One page, or the whole site?
- Whole site, crawl mode:
crawl_site{ "url": "<home page>", "maxPages": 100 }, thenlist_pages{ "indexable": true, "limit": 200 }. Group URLs by path pattern into templates (home, category, product, article, location, contact, about). Pick one representative URL per template. - One page: use the URL or pasted source given.
- Whole site, crawl mode:
- Get the HTML of each representative page. Prefer a raw fetch (
curl -sL <url>) over a summarising fetch, since you need the exact<script type="application/ld+json">blocks. Note that markup injected by JavaScript will be missing from a raw fetch; if the user says markup exists and you see none, that is why. Google can read injected JSON-LD, though less reliably for fast-changing data such as price. - Inventory existing markup: every JSON-LD block, plus any microdata (
itemscope) or RDFa. For each block record@type, whether it parses as JSON, and its properties. - Validate each block against the rules and the type table below.
- Decide what the page should have from the table. Remove or stop maintaining types that earn nothing.
- Write the JSON-LD, filled with values taken from the page. Where a required value is not on the page, put a clearly marked placeholder and list it under "You need to supply".
- Report in the output format.
Rules that apply to every type
- JSON-LD in a
<script type="application/ld+json">is the format Google recommends. Head or body are both fine. - Valid JSON: double quotes, no trailing commas, no comments, special characters escaped. One syntax error voids the whole block.
- Markup must match visible content. Do not mark up reviews, prices, FAQs or authors that a visitor cannot see on that page. This is the commonest cause of a manual action for structured data.
- Mark up the page's main thing, on that page. Product markup belongs on the product page, not on a category page listing twenty products.
- Absolute URLs for
url,image,logo,@id,sameAs. - Dates in ISO 8601 with a timezone where time matters:
2026-03-14T09:00:00+00:00. - Connect entities with
@id(for examplehttps://example.com/#organization) and reference that@idfrompublisher,author,brand, so parsers see one organisation and not five. Several types can share one block inside"@graph": [...]. - Required properties are a gate: missing one means no rich result for that item. Recommended properties improve eligibility and display.
- Eligible is not guaranteed. Google decides per query whether to show a rich result.
Types worth writing, and what Google needs
Google changes this list several times a year. Treat the table as a starting point and confirm against Google's structured data gallery (https://developers.google.com/search/docs/appearance/structured-data/search-gallery) before promising a rich result.
| Page | Type | Required by Google | Add if on the page |
| Home or about | Organization (or a subtype) | none strictly; give name, url | logo, sameAs, contactPoint, legalName, description |
| Home | WebSite | name, url | alternateName (site name shown in results) |
| Any page below the home page | BreadcrumbList | itemListElement with position, name, item (the last item may omit item) | |
| Blog post, news, guide | Article, BlogPosting or NewsArticle | none strictly | headline, image, datePublished, dateModified, author with name and url |
| Product page that sells | Product with offers | name, image, offers with price, priceCurrency | availability, sku, gtin, brand, aggregateRating, review, shippingDetails, hasMerchantReturnPolicy |
| Product page that reviews | Product | name plus one of review, aggregateRating, offers | |
| Physical business | LocalBusiness (most specific subtype) | name, address | telephone, openingHoursSpecification, geo, priceRange, url, image |
| Event | Event | name, startDate, location | endDate, eventStatus, eventAttendanceMode, offers, image, organizer |
| Job advert | JobPosting | title, description, datePosted, hiringOrganization, jobLocation (or remote fields) | validThrough, baseSalary, employmentType |
| Recipe | Recipe | name, image | recipeIngredient, recipeInstructions, times, nutrition, aggregateRating |
| Page whose main content is a video | VideoObject | name, thumbnailUrl, uploadDate | description, duration, contentUrl or embedUrl |
| Software or app page | SoftwareApplication | name, offers.price (0 for free), and aggregateRating or review | applicationCategory, operatingSystem |
| Author or member profile | ProfilePage | mainEntity (a Person or Organization) with name | sameAs, description, image |
| Forum thread or single user question | DiscussionForumPosting, QAPage | see Google's page for each |
Review stars: aggregateRating needs ratingValue and ratingCount or reviewCount. Ratings must be about the specific item, collected on that page. Stars are not shown for LocalBusiness or Organization when the business marks up reviews of itself on its own site.
Types that no longer earn a rich result
Say this plainly when the user asks for one, so they do not wait for a result that will not come.
FAQPage: since August 2023 the FAQ rich result is shown only for well-known government and health sites. For anyone else it earns no rich result. The markup is harmless and still states question and answer pairs for machines, so write it if asked and say what it will not do.HowTo: the rich result was removed in 2023.- Sitelinks search box (
WebSitewithSearchAction): removed in late 2024. - Google announced in 2025 that it was retiring several minor types, among them Course Info, Claim Review, Estimated Salary, Learning Video, Special Announcement and Vehicle Listing. Check the gallery before writing any of these.
Common faults when validating existing markup
- JSON syntax error: trailing comma, curly quotes pasted from a document, unescaped quote inside a description.
- Wrong nesting:
priceonProductin place of onoffers;authoras a bare string wherePersonwithnameis wanted (a string is tolerated, an object is better). @typemisspelt or wrong case (Localbusiness), or an invented property name. schema.org names are case-sensitive.- Relative
imageorurlvalues. aggregateRatingwith no visible reviews, or copied from a third-party site.- Several blocks describing the same organisation with different names, logos or URLs, usually from a theme and a plugin both emitting markup. Keep one.
datePublishedin a local format (14/03/2026).Productmarkup on a category page, orArticleon a product page.availabilityas free text. Usehttps://schema.org/InStock,OutOfStock,PreOrderand so on.- Price with a currency symbol or thousands separator: use
"price": "1299.00","priceCurrency": "GBP".
Output format
# Schema markup: <page or site>
Seen: <N> page(s): <URLs>. <In crawl mode: chosen as representatives of T templates from a crawl of M pages.>
## What is there now
| Page | Type found | Valid JSON | Problems |
## What to change
1. <fix or addition, the page or template it applies to, and what it makes the page eligible for>
## JSON-LD
### <page type or URL>
<one fenced json code block, complete and ready to paste, inside the script tag>
## You need to supply
- <each placeholder left in the markup, and where the value should come from>
## Test it
Paste the page URL or the code into Google's Rich Results Test (https://search.google.com/test/rich-results) for rich result eligibility, and the Schema Markup Validator (https://validator.schema.org/) for schema.org syntax.Placeholders use the form "REPLACE: opening hours for Monday" so they cannot be shipped unnoticed.
Wrong conclusions to avoid
- "Schema will improve rankings." It makes pages eligible for richer display and clarifies entities. Promise eligibility, never position.
- "I validated it." You checked it against the rules here. Only the Rich Results Test confirms what Google accepts. Always send the user there.
- Inventing values to satisfy a required property. A made-up rating, price or address is worse than no markup. Leave a placeholder.
- Adding every type that could apply. More types do not mean more results. One correct primary type per page, plus
BreadcrumbList, andOrganizationonce on the home page, covers most sites. - Assuming the template is consistent. You checked one representative per template. Say so. If the user needs every page verified at scale, that is a job for a crawler that extracts structured data, which the bundled tools here do not do.
- No rich result a week after adding markup is normal. Google needs to recrawl, and may still choose not to show it.
Page mode notes
Without the crawl tools nothing in this skill changes except the survey step: you cannot list the site's templates. Work from the pages given, ask for the page source (View Source) when you cannot fetch, and state "I have seen N pages" in the report.
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.

