skills/soborbo/claudeskills/schema-patterns

schema-patterns

SKILL.md

Schema Patterns Skill

Purpose

Provides comprehensive Schema.org markup patterns for lead generation sites to maximize rich snippet visibility in search results. Implement structured data to enable knowledge panels, FAQ accordions, star ratings, and other rich SERP features that increase click-through rates.

Core Rules

One primary schema per page - LocalBusiness OR Organization at root
Nest related schemas - Reviews inside LocalBusiness, not separate
Validate always - Test with Google Rich Results Test before deployment
Match visible content - Schema must reflect what users see on page
Keep updated - Hours, prices, reviews must be current
Use absolute URLs - All image and link URLs must be absolute, not relative
Follow Google requirements - Check required fields for each schema type
No fake content - Only use real, verifiable reviews and ratings
Test in production - Validate with Search Console after deployment
Prioritize P0 schemas - LocalBusiness and FAQPage first for lead gen

Schema Priority for Lead Gen

Priority	Schema Type	Rich Result	Page Type
P0	LocalBusiness	Knowledge panel, maps	All pages
P0	FAQPage	FAQ accordion in SERP	FAQ sections
P1	Service	Service listings	Service pages
P1	BreadcrumbList	Breadcrumb trail	Inner pages
P1	AggregateRating	Star ratings	Business pages
P2	HowTo	Step-by-step cards	Guide content
P2	Article	Article cards	Blog posts
P3	VideoObject	Video thumbnails	Video content
P3	Product	Product cards	Product pages

References

Schema Implementation Files

LocalBusiness & Service Schemas - Business and service markup
FAQ & HowTo Schemas - FAQ pages and step-by-step guides
Article & VideoObject Schemas - Blog posts and video content
Supporting Schemas - BreadcrumbList, Review, WebSite, combined examples
Validation & Testing - Validation code, testing tools, common mistakes

External Resources

Google Rich Results Test - Primary validation tool
Schema.org Validator - Official schema validator
Google Search Central - Schema guidelines
Schema.org Documentation - Complete schema reference

Quick Start

Add LocalBusiness schema to your base layout (all pages)
Add FAQPage schema to pages with FAQ sections
Add Service schema to service-specific pages
Add BreadcrumbList schema to all inner pages
Validate all schemas with Google Rich Results Test
Monitor Search Console for schema errors
Update business info (hours, prices) regularly

Usage Example

---
// src/layouts/BaseLayout.astro
import LocalBusinessSchema from '@/components/schema/LocalBusinessSchema.astro';
import BreadcrumbSchema from '@/components/schema/BreadcrumbSchema.astro';

const breadcrumbs = getBreadcrumbs(Astro.url.pathname);
---

<html>
  <head>
    <LocalBusinessSchema {...siteConfig.business} />
    {breadcrumbs.length > 1 && <BreadcrumbSchema items={breadcrumbs} />}
  </head>
  <body>
    <slot />
  </body>
</html>