Schema Markup
When the user wants to implement, audit, or validate structured data (schema markup) on their website.
Before & after
Same prompt, same agent — the only difference is the skill.
Schema markup is structured data that tells Google what your content is about, and it can help your content appear in rich snippets and featured snippets. For FAQs, you'd use schema.org markup that identifies questions and answers. It's mostly JSON-LD format embedded in your HTML. The challenge is making sure the markup is actually correct—Google is picky about formatting and structure. Have you already created the FAQ content, or are we starting from scratch? Also, which tool are you using to manage your website?
FAQ SCHEMA IMPLEMENTATION
GOAL
Rank 15 help articles for featured snippets (currently ranking 0)
STEP 1: MARKUP SETUP (JSON-LD)
Add to <head> of each help article page:
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "How do I set up automated customer check-ins?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Configure your agent in Settings > Automation. Define check-in frequency (daily, weekly) and target customer segments. Agent activates immediately."
}
},
{
"@type": "Question",
"name": "Can the agent handle objections?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Yes. The agent is trained on your responses to common objections. It recognizes patterns and escalates complex objections to a human CSM."
}
}
]
}
STEP 2: CONTENT STRUCTURE
Each answer must be:
• 40-60 words (optimal for featured snippets)
• Clear, direct language (no jargon)
• Answer the question in the first sentence
• No links or HTML in the answer text (plain text only)
STEP 3: VALIDATION
Run each page through Google's Rich Results Test
• Paste URL
• Check for errors (schema format issues)
• Verify FAQPage markup detected
• Common errors: missing text, invalid schema type
TEST RESULTS (from first 3 articles):
✓ Article 1 (setup): Schema valid, preview shows on Google
✗ Article 2 (objections): Schema valid but answer too long (98 words → trim to 50)
✓ Article 3 (billing): Schema valid, answer clear and actionable
STEP 4: SEARCH CONSOLE AUDIT
1. Submit sitemap (confirms Google knows about your help pages)
2. Monitor Search Console for "rich results"
3. Within 2-4 weeks, look for "FAQ" in results type
4. Track impressions (how often content appears in snippets)
5. Click-through rate (what percentage of impressions become clicks)
STEP 5: RANKING OPTIMIZATION
These articles need both markup AND traditional SEO:
• Page title includes target keyword ("How to Automate Customer Check-ins with AI")
• Meta description under 160 chars
• Headings use target keyword naturally
• Internal links from related articles
• Mobile-responsive (mobile-first indexing)
STEP 6: MONITORING
Three months post-launch, measure:
Featured snippet impressions in Search Console (target: 50-100/month)
Click-through rate from snippets (typically 5-8%)
Ranking position improvement (most should move to page 1 within 90 days)
SETUP GOTCHAS
Gotcha 1: If answer is HTML or contains links, schema breaks
→ Keep text plain, move links elsewhere
Gotcha 2: If Q&A pairs aren't chronological or relevant, Google ignores markup
→ Structure by user journey (setup → common issues → advanced)
Gotcha 3: Schema markup alone doesn't guarantee rankings
→ You still need good SEO (keywords, backlinks, user experience)
INSTALLATION METHOD
If using static HTML: manually add JSON-LD to each page's <head>
If using CMS (WordPress): install Yoast SEO plugin, configure FAQ blocks per post
If using Next.js: use next-seo library with faqSchema componentAbout this skill
name: schema-markup description: Use when When the user wants to implement, audit, or validate structured data (schema markup) on their website.
Schema Markup
When the user wants to implement, audit, or validate structured data (schema markup) on their website. Use when the user mentions 'structured data,' 'schema.org,' 'JSON-LD,' 'rich results,' 'rich snippets,' 'schema markup,' 'FAQ schema,' 'Product schema,' 'HowTo schema,' or 'structured data errors in Search Console.' Also use when someone asks why their content isn't showing rich results or wants to improve AI search visibility. NOT for general SEO audits (use seo-audit) or technical SEO crawl issues (use site-architecture).
What you get
- Public GitHub repo (alirezarezvani/claude-skills)
- the schema-markup skill folder with SKILL.md. Part of a 337-skill / 30-agent / 70-command install.
Customize your output
- Fork the repo and adapt the skill's instructions and references to your workflow.
Example output
Activates automatically when your request matches Schema Markup; chains with the other skills, agents, and commands in the collection.
Best for
Creators, builders, and teams using Claude Code.
SKILL.md preview
---
name: schema-markup
description: Use when implementing, auditing, or validating structured data (schema markup) on a website, including JSON-LD and rich-result eligibility.
version: 1.0.0
category: Marketing
author: AgentVolt
license: proprietary
tags:
- marketing
---
# Schema Markup
Implements, audits, and validates structured data on a website using JSON-LD, targeting rich-result eligibility and better machine readability.
## When to use
- Implementing new structured data for a page type
… (sign up to view the full skill)Featured in
More marketing & growth skills
View all Marketing & Growth skills →Paid Ads
When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.
Onboarding CRO
When the user wants to optimize post-signup onboarding, user activation, first-run experience, or time-to-value.
Social Media Manager
When the user wants to develop social media strategy, plan content calendars, manage community engagement, or grow their social presence across platforms.
Analytics Tracking
Set up, audit, and debug analytics tracking implementation — GA4, Google Tag Manager, event taxonomy, conversion tracking, and data quality.