skills.rest
akp-alliance
akp-allianceCOMMUNITY
Explore all skills by this author →
GitHub

schema-markup

Implement schema.org JSON-LD structured data and validate with Rich Results Test.

4|4|Updated Mar 21, 2026
Search Tags:#schema.org#json-ld#schema markup#rich results#faqpage#seo validation#breadcrumblist
One-click install
npx skills add https://github.com/akp-alliance/npx-skills-add-coreyhaines31-marketingskills --skill schema-markup-akp-alliance
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: schema-markup
Source: https://github.com/akp-alliance/npx-skills-add-coreyhaines31-marketingskills/tree/main/.claude/skills/schema-markup
Command: npx skills add https://github.com/akp-alliance/npx-skills-add-coreyhaines31-marketingskills --skill schema-markup-akp-alliance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Schema-markup helps you add accurate schema.org structured data so search engines can better understand your pages and potentially display richer results in Google.

Core Features & Use Cases

  • Schema selection & planning: Choose the right schema type based on page intent and eligible rich-result opportunities (e.g., Organization, Article, Product, FAQPage, BreadcrumbList).
  • JSON-LD implementation guidance: Use JSON-LD and structure multiple types safely with @graph when needed.
  • Validation and debugging workflow: Test with Google Rich Results Test and validate with the Schema.org validator, then fix common issues like missing required properties or mismatches with visible content.
  • Tech stack aware instructions: Tailor implementation approach for static sites, React/Next.js, and CMS/WordPress via plugins or custom fields.

Quick Start

Use the schema-markup skill to add correct JSON-LD structured data for your target page type, then validate it in Google’s Rich Results Test before publishing.

Frequently Asked Questions about schema-markup

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

FAQPage Schema
How do I add JSON-LD schema markup to a webpage for Google rich results?▼

You add JSON-LD schema markup by mapping schema.org properties to visible on-page content and injecting the structured data script into your HTML, optionally using @graph for multiple types.

What is the best way to validate schema markup before publishing?▼

The best way to validate schema markup is testing with Google's Rich Results Test to confirm rich-result eligibility, then verifying syntax accuracy with the Schema.org validator to catch missing required properties.

Can I use multiple schema.org types on a single page using @graph?▼

Yes, you can use multiple schema.org types on a single page by structuring your JSON-LD with the @graph array, which safely links separate entities like Organization, BreadcrumbList, and FAQPage within one script block.

How do I fix schema markup errors when properties mismatch visible content?▼

To fix schema markup mismatches, ensure every JSON-LD property precisely matches the visible text on the page, then rerun the Rich Results Test to confirm all missing required properties and errors are resolved.

Does schema markup implementation work differently for React and Next.js sites?▼

Schema markup implementation for React and Next.js requires tailored approaches to inject JSON-LD scripts correctly within component lifecycles or head sections, compared to static HTML or CMS WordPress plugins.

When do I need BreadcrumbList schema markup on my site?▼

You need BreadcrumbList schema markup when your site has hierarchical navigation, enabling search engines to display breadcrumb trails in rich results and improving search understanding of your site structure.

Related Skills

Explore More Marketing & Sales Skills→
Gull-StackGull-Stack

schema-markup

Generate JSON-LD schema markup for common page types with required properties.

Official
Basic
shenxingyshenxingy
8

seo-schema

Detect and generate Schema.org JSON-LD structured data for web pages.

Community
Advanced
lostitonce420-beeplostitonce420-beep

seo-auditor

Audit websites for SEO issues and generate a prioritized action plan.

Community
Advanced
michalstanieckomichalstaniecko

seo-schema

Implement Schema.org and JSON-LD structured data in WordPress pages.

Community
Intermediate