When the user wants to add, fix, or optimize schema markup and structured data on their site. Also use when the user mentions "schema markup," "structured data," "JSON-LD," "rich snippets," "schema.org," "FAQ schema," "product schema," "review schema," "breadcrumb schema," "Google rich results," "knowledge panel," "star ratings in search," or "add structured data." Use this whenever someone wants their pages to show enhanced results in Google. For broader SEO issues, see seo-audit. For AI search
This skill focuses on adding, fixing, and optimizing schema markup and structured data using schema.org standards to help search engines better understand web content. It enables the implementation of JSON-LD code for various schema types such as Product, FAQPage, Article, BreadcrumbList, and Organization, which can drive enhanced Google search results like rich snippets, star ratings, knowledge panels, and breadcrumb trails. The skill also covers validation using tools like Google Rich Results Test and Search Console enhancements to ensure markup accuracy and effectiveness.
This skill is designed for SEO specialists aiming to improve organic visibility through rich results, PPC operators who want to increase ad relevance by aligning landing pages with structured data, and digital marketing agencies managing multiple clients’ websites needing consistent, scalable schema implementation. It is especially relevant for those working on e-commerce product pages, content publishers targeting article and FAQ rich snippets, and local businesses seeking improved knowledge panel presence.
First, assess the page type and its primary content to determine which schema types apply and the potential rich results to target. Next, audit existing structured data for errors or gaps using Google’s Rich Results Test and Search Console reports. Then, implement or correct JSON-LD markup, ensuring all required properties—such as name, url, offers, and mainEntity—are accurately populated from page content or data sources. Finally, validate and test the markup to confirm it passes Google’s guidelines and matches visible content, iterating as needed to optimize for the desired rich result appearance.
What schema types should I prioritize for my product pages? Focus on Product schema with required properties like name, image, and offers to enable price and availability rich snippets. How do I handle multiple schema types on one page? Combine them using the JSON-LD `@graph` property to include Organization, BreadcrumbList, and others without conflicts. What tools can verify my structured data? Use the Google Rich Results Test, Schema.org Validator, and Search Console Enhancements report to identify errors and validate schema markup.
Attach this skill to any agent task where users mention schema markup, structured data, or related terms like JSON-LD, FAQ schema, or rich snippets. The agent will guide the user through assessing current markup, selecting appropriate schema types, implementing JSON-LD, and validating the results. Expect the skill to provide targeted recommendations for improving structured data to increase the chances of enhanced search appearances and better SEO outcomes. This overview will be supplemented further with internal links to relevant resources.
For broader context, see our roundup of claude skills for marketing, and read Claude skills for SEO for related setup guidance.