# Schema Markup AI Skill for JSON-LD > Choose schema types for your kind of site, write them as JSON-LD, and validate the markup against each page with a free schema markup AI skill. Source: https://scayverstaging.1wp.site/resources/schema-markup-ai-skill/ ![A computer monitor displaying code sits on a wooden desk with a keyboard and phone by a window.](https://scayverstaging.1wp.site/wp-content/uploads/2026/09/sg-resources-146122-hero.webp) Hand this schema markup AI skill to your agent when pages carry no structured data or show errors: it writes JSON-LD and checks every property against the visible page. [Talk to a Specialist](https://scayverstaging.1wp.site/talk-to-a-specialist/?form=book) [Every resource](https://scayverstaging.1wp.site/resources/) **Format** [AI Skill](https://scayverstaging.1wp.site/resources/type/ai-skill/) **In this format** 20 ## JSON-LD over Microdata and RDFa The skill settles the format first. JSON-LD sits in its own script tag, so you can add, change, or remove it without touching the visible HTML, and Google recommends it. Microdata is woven into your markup, which makes it harder to audit, and the skill sees little reason to start anything new in RDFa. It prefers the page head, and it accepts the body when a content management system leaves no other option. ## Schema types by kind of site - A software company gets Organization on the homepage, SoftwareApplication on product pages, FAQPage on pricing and support pages, and BlogPosting on posts. - An online store gets Organization, then Product with Offers and AggregateRating on every product page, plus BreadcrumbList on category and product pages. - A local services business gets LocalBusiness on the homepage and every location page, FAQPage on service pages, and Review where reviews are published. - A publisher gets Organization, Article or BlogPosting on each article, and BreadcrumbList across the site. The highest priority types go in first, get validated, and only then does the next set follow. ## Rules for every page Markup describes only what a visitor can see on the page. Reviews written by your own team never appear as independent ratings. Product markup without an Offers block cannot show a price, so the skill always includes one, and a rating needs a numeric value before stars can appear. Each location gets its own LocalBusiness block with its own address, phone, and hours. Category pages never receive Product markup, because a list of products is not a product. ## Validation before it ships The Rich Results Test comes first. It shows which result types a page qualifies for, which properties it detected, and which required ones are missing. The skill reads a warning as a note and an error as a blocker. The Schema Markup Validator then catches broken syntax, and Search Console’s Enhancements reports show errors across many pages at once. After a fix, the skill has you request reindexing and allow 48 to 72 hours before judging the result. ## Examples and rules in the schema file Ready to adapt JSON-LD samples for Organization and FAQPage live in the [schema skill file](https://github.com/scayver/marketing-skills/blob/18243d7675fa83638f20c660e31311c1bf03294d/skills/schema/SKILL.md), along with notes for WordPress, Shopify, Webflow, and Next.js. The repository is released under the [MIT License](https://github.com/scayver/marketing-skills/blob/18243d7675fa83638f20c660e31311c1bf03294d/LICENSE), “Copyright (c) 2026 ScayverGraphix.” The skills follow the Agent Skills spec published by vercel-labs/skills. ## Point it at one template. Mention JSON-LD, rich results, or a specific type such as Product schema, and the agent loads the skill. The project readme lists it after seo-content-strategy and seo-blog-writer on the path for building search traffic. You can add the three at once with `npx skills add scayver/marketing-skills --skill seo-content-strategy seo-blog-writer schema`. ## Markup is a prerequisite, not a promise. The skill says so itself. Structured data makes a page eligible for rich results and easier for AI systems to read correctly, but neither outcome is certain. It also needs upkeep: an old price, a past event, or a stale modified date in the markup is an error the moment the page changes. ## A larger technical problem behind the markup Markup errors can sit beside other problems, such as a blocked route or two pages that declare conflicting canonical destinations. Our [Technical SEO service](https://scayverstaging.1wp.site/services/optimization/technical-seo/) traces a problem to the affected routes, defines the change, and checks what happened after release. [Talk to a Specialist](https://scayverstaging.1wp.site/talk-to-a-specialist/) Keep reading ## Read after Schema Markup AI Skill. The rest of the resources, newest first. - [2 July 2026 Customer Persona Worksheet](https://scayverstaging.1wp.site/resources/customer-persona-worksheet/) - [2 July 2026 The Social Content Sprint Playbook](https://scayverstaging.1wp.site/resources/the-social-content-sprint-playbook/) - [2 July 2026 AI Prompt Pack for Blog Post Outlines](https://scayverstaging.1wp.site/resources/ai-prompt-pack-for-blog-post-outlines/) - [2 July 2026 Email Welcome Sequence Template](https://scayverstaging.1wp.site/resources/email-welcome-sequence-template/) - [2 July 2026 Website Pre Handoff QA Checklist](https://scayverstaging.1wp.site/resources/website-pre-handoff-qa-checklist/) - [2 July 2026 The SEO Content Audit Guide](https://scayverstaging.1wp.site/resources/the-seo-content-audit-guide/) - [2 July 2026 Positioning Statement Worksheet](https://scayverstaging.1wp.site/resources/positioning-statement-worksheet/) - [2 July 2026 The Client Onboarding Playbook](https://scayverstaging.1wp.site/resources/the-client-onboarding-playbook/) - [2 July 2026 AI Prompt Pack for Ad Headline Variations](https://scayverstaging.1wp.site/resources/ai-prompt-pack-for-ad-headline-variations/) - [2 July 2026 The One Page Creative Brief Template](https://scayverstaging.1wp.site/resources/the-one-page-creative-brief-template/) - [2 July 2026 Brand Launch Readiness Checklist](https://scayverstaging.1wp.site/resources/brand-launch-readiness-checklist/) - [2 July 2026 The Landing Page Teardown Guide](https://scayverstaging.1wp.site/resources/the-landing-page-teardown-guide/) FAQ ## Questions about structured data The things people ask on the first call. If yours is not here, ask us directly. [Ask us directly](https://scayverstaging.1wp.site/talk-to-a-specialist/?form=book) **Will FAQ markup bring back FAQ results in Google?** Not reliably. The skill notes that Google now shows FAQ rich results far less often in standard searches, though it still reads the markup to understand the page. Add FAQPage only where the questions and answers are visible to readers. **Does it work with a WordPress SEO plugin that already adds schema?** Yes. The skill tells you to check what plugins such as Yoast, Rank Math, or Schema Pro already produce with the Rich Results Test. That check keeps you from adding a second, conflicting block for the same type.