schema-markup

name	schema-markup
description	Schema.org structured data: generate JSON-LD for rich results, validate markup, choose the right schema type, implement across common page types

Schema Markup Skill

When to activate

• Adding structured data to improve rich results in Google Search
• Generating JSON-LD for articles, products, FAQs, how-tos, reviews, local businesses
• Validating schema markup before deployment
• Choosing the right schema type for a page
• Debugging why rich results aren't appearing

When NOT to use

• Schema alone won't rank you — it enhances existing good content
• Fake reviews or misleading data — Google will penalise
• For every page on your site — prioritise high-value pages first

Instructions

Choose the right schema type

What schema markup should I use for this page?

Page type/content: [describe what the page contains]
Goal: [rich snippets / knowledge panel / local pack / voice search]

Common schema types:
- Article / BlogPosting: news, blog posts, editorial content
- Product: ecommerce product pages with price, availability, reviews
- LocalBusiness: physical locations (includes opening hours, address)
- FAQPage: pages with Q&A sections (appears as expandable in SERPs)
- HowTo: step-by-step instructions
- Recipe: cooking content with ingredients, steps, nutrition
- Event: conferences, concerts, webinars
- JobPosting: job listings
- Course: online learning content
- SoftwareApplication: apps and software tools
- Review / AggregateRating: user or expert reviews
- BreadcrumbList: site navigation hierarchy
- Organization: company information, social profiles
- Person: author, speaker, professional profiles

Which types apply? Can multiple types be combined?

Generate JSON-LD (paste-ready)

Article / Blog Post:

Generate Article schema for:
Title: [title]
Author: [name, URL]
Published: [date]
Modified: [date]
Image: [URL]
Publisher: [company name, logo URL]
URL: [page URL]
Description: [meta description]

LocalBusiness:

Generate LocalBusiness schema for:
Business name: [name]
Type: [Restaurant / MedicalClinic / LegalService / Store / etc.]
Address: [full address]
Phone: [number]
Website: [URL]
Hours: [Mon-Fri 9-5, Sat 10-3, etc.]
Price range: [$$ / $$$]
Latitude/Longitude: [if known]

FAQPage:

Generate FAQPage schema for these Q&As:
Q1: [question]
A1: [answer]
Q2: [question]
A2: [answer]
[add as many as needed — 5-10 is ideal]
Page URL: [URL]

Product:

Generate Product schema for:
Name: [product name]
Description: [description]
Image: [URL]
Brand: [brand name]
SKU: [SKU if available]
Price: [amount]
Currency: [USD/GBP/EUR]
Availability: InStock / OutOfStock / PreOrder
Rating: [average score] from [count] reviews

HowTo:

Generate HowTo schema for this tutorial:
Title: [how-to title]
Description: [what this teaches]
Total time: [PT30M = 30 minutes]
Steps:
1. [step name] — [step description]
2. [step name] — [step description]
[continue for all steps]

Validate and debug

Validate this schema markup:

[paste JSON-LD code]

Check:
1. Valid JSON syntax?
2. Required fields present for this schema type?
3. Recommended fields missing (that would enable rich results)?
4. Any deprecated properties?
5. Testing URL: https://search.google.com/test/rich-results

Also check: is this schema type eligible for rich results?
(Not all schema types generate visual enhancements — some just help understanding)

Implementation across page types

Create a schema markup implementation plan for my site.

Site type: [blog / ecommerce / local business / SaaS / marketplace]
Main page types: [list: homepage, product pages, blog posts, category pages, etc.]

For each page type:
1. Recommended schema type(s)
2. Data fields to include
3. Which fields are dynamic (from CMS/DB) vs. static
4. Priority: [high — rich result eligible / medium / low]
5. Implementation method: [HTML head / CMS plugin / via GTM / server-rendered]

Output: priority-ordered implementation checklist.

Example

User: I have a SaaS review blog. Each post reviews a tool. I want rich snippets in Google.

Claude generates:

For a review post, use SoftwareApplication + Review combined:

{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "Notion",
  "applicationCategory": "ProductivityApplication",
  "operatingSystem": "Web, iOS, Android, macOS, Windows",
  "offers": {
    "@type": "Offer",
    "price": "0",
    "priceCurrency": "USD",
    "description": "Free tier available"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.6",
    "reviewCount": "1",
    "bestRating" 
     
  
   
     
          
     
     
       
       
       
    
     
  

Rich result eligibility: ✅ Product rich snippets (star ratings in SERPs)

---