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," or "breadcrumb schema." For broader SEO issues, see seo-audit.
Schema Markup enables search engines to better interpret your website content by adding structured data following schema.org standards. This improves the chances of earning rich snippets—such as product ratings, FAQ accordions, or breadcrumb trails—in search results, which can increase click-through rates and visibility. The skill focuses on assessing the current schema implementation, selecting the right schema types for the page, and optimizing or fixing JSON-LD to align with SEO goals.
This skill is essential for SEO specialists managing on-site optimization who want to enhance organic search performance through rich results. It also benefits e-commerce managers aiming to highlight product details like pricing and reviews in search snippets, as well as content marketers or growth leads responsible for blog and article pages that can leverage Article or FAQ schema. Agencies handling diverse client sites with varying content types will find this skill useful for audit and implementation.
Start by auditing the existing schema on a page to identify errors, missing fields, or outdated markup. Next, determine the page’s content type—such as product, article, FAQ, or organization—and select the appropriate schema type accordingly. Then, build or refine the JSON-LD script ensuring required and recommended properties are included, like name, URL, offers, or author details. Finally, validate the schema with tools like Google’s Rich Results Test and monitor search console reports for coverage and enhancement status.
How do I choose the right schema type for my page? Select the schema that matches the primary content and the rich result you want to target, such as Product for e-commerce or FAQPage for support content. Can I add multiple schema types on one page? Yes, combining schemas like Organization and WebSite is common, but avoid redundancy and keep markup accurate. What’s the best format for schema? JSON-LD is the recommended approach because it’s easy to maintain and preferred by search engines.
Attach this skill to a Metaflow agent task when you need to add, fix, or optimize schema markup on a website page. The agent will focus on reviewing existing structured data, selecting proper schema types, and outputting updated JSON-LD scripts aligned with SEO goals. Expect clear, actionable markup improvements that you can implement directly or hand off to developers for deployment. This skill integrates smoothly with other SEO-related tasks for comprehensive site optimization workflows.
For broader context, see our roundup of claude marketing skills, and read Claude skills for SEO for related setup guidance.