schema-markup

Implement JSON-LD schema.org markup and validate with Google Rich Results Test.

7.3k|977|Updated Oct 29, 2025
One-click install
npx skills add https://github.com/TheCraigHewitt/seomachine --skill schema-markup-thecraighewitt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: schema-markup
Source: https://github.com/TheCraigHewitt/seomachine/tree/main/.claude/skills/schema-markup
Command: npx skills add https://github.com/TheCraigHewitt/seomachine --skill schema-markup-thecraighewitt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Schema markup and structured data are essential for search engines to understand content and surface rich results. This Skill guides you to implement accurate JSON-LD and schema.org markup across pages, reducing guesswork and misinterpretation.

Core Features & Use Cases

  • Accurate Markup Guidance: Learn which schema types to apply (Organization, WebSite, Article, Product, FAQPage, BreadcrumbList, etc.) and how to structure properties.
  • Validation-Oriented Workflows: Provide step-by-step validation checks and recommended tools (Google Rich Results Test, Schema Validator) to ensure correct implementation.
  • Use Case Coverage: Ideal for content pages, product pages, FAQs, blog posts, and navigational breadcrumbs that should show rich results.

Quick Start

Describe and implement schema markup for a standard blog post: add an Article schema with headline, image, datePublished, author, and mainEntityOfPage, then validate.

Frequently Asked Questions about schema-markup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add schema markup to improve search engine understanding of my content?

Schema markup uses JSON-LD syntax to embed structured data into your pages, telling search engines what your content is about. Apply the correct schema type—Article, Product, FAQPage, Organization—with required properties like headline, image, and datePublished, then validate using Google's Rich Results Test to ensure accuracy.

What schema types should I use for different page types?

Schema types vary by content: Article for blog posts, Product for e-commerce, FAQPage for FAQ sections, BreadcrumbList for navigation, and Organization for company information. Match the schema type to your page's primary content to enable rich results and improve indexing.

How do I validate schema markup to ensure it's correct?

Validate JSON-LD markup using Google's Rich Results Test and Schema Validator tools to check syntax and property mappings against schema.org guidelines. Testing catches errors before deployment and confirms your markup will generate rich results in search.

Can schema markup help my website rank better in search results?

Schema markup doesn't directly boost rankings but enables rich results—enhanced search snippets with ratings, prices, or FAQs—that increase click-through rates. Accurate structured data helps search engines understand and surface your content more effectively.

What's the difference between schema markup and meta tags?

Meta tags provide basic page information like title and description; schema markup (JSON-LD) adds detailed structured data that enables rich results and deeper content understanding. Both are needed: meta tags for page indexing, schema markup for semantic clarity and enhanced search features.

Do I need coding skills to implement schema markup?

Schema markup requires understanding JSON-LD syntax and schema.org property mappings, but no advanced programming is needed. You add code blocks to page templates, match properties to your content, and validate—accessible to developers and content managers with basic technical familiarity.