Schema Markup Implementation — Business

This skill helps implement, audit, and validate structured data (schema markup) using JSON-LD to earn rich results in Google and improve AI search visibility. It provides guidance on schema type selection, implementation patterns, common mistakes, and testing methods.

marketing claude-code

📂 View skill on GitHub ↗ 🚀 How to use

✨ What it does

Audits existing schema markup and identifies missing or broken fields.
Generates copy-paste-ready JSON-LD for various page types (Article, Product, FAQ, etc.).
Validates schema using Google Rich Results Test, Schema.org Validator, and a local script.
Provides guidance on schema placement and CMS-specific implementation.
Highlights common mistakes that kill rich results eligibility.
Explains how schema improves AI search visibility and offers practical actions.

🎯 When to use it

When the user wants to add structured data to a website for rich results or AI search visibility.
When the user reports structured data errors in Google Search Console or rich results not showing.
When the user asks about schema markup, JSON-LD, FAQ schema, Product schema, or similar.
When the user wants to audit existing schema markup for correctness and completeness.

🚀 How to use

Trigger: /image

Trigger the skill by asking to implement, audit, or validate schema markup, or by mentioning structured data, JSON-LD, rich results, or specific schema types. Provide the page URL or HTML, the page type, and your goals (e.g., fix errors, add FAQ schema). The skill will guide you through the process and deliver JSON-LD or an audit report.

Example prompts:

Can you audit the schema markup on my product page? Here's the URL: https://example.com/product
I need to add FAQ schema to my FAQ page. Can you generate the JSON-LD?

📄 Output: Deliverables include JSON-LD code blocks, audit reports, or corrected schema with explanations, depending on the request.

📦 Add this skill to Claude Code

# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills

# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/marketing-skill/skills/schema-markup .claude/skills/schema-markup

Skill source: marketing-skill/skills/schema-markup/SKILL.md

⚠️ Good to know

The skill assumes the user can edit the website's head or use a CMS plugin; it does not handle full SEO audits or technical crawl issues.

❓ FAQ

What is the recommended format for schema markup?

JSON-LD is recommended because Google prefers it, it's easy to maintain, and it doesn't require altering HTML markup.

Why is my FAQ schema not showing rich results?

Common reasons include missing required fields, markup not matching visible content, or schema injected via GTM which Google may not index. Ensure FAQPage schema is present and test with the Rich Results Test.

Can I stack multiple schema types on one page?

Yes, stacking compatible types is fine, but avoid adding schema that doesn't match the page content. For example, add BreadcrumbList to non-homepages and Article with Person for blog posts.

🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.