home / skills / madappgang / claude-code / schema-markup

schema-markup skill

safe

This skill helps you implement and validate schema.org markup for rich results, guiding you from planning to testing across content.

npx playbooks add skill madappgang/claude-code --skill schema-markup

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

2.0 KB

---
plugin: seo
updated: 2026-01-20
name: schema-markup
description: Schema.org markup implementation patterns for rich results. Use when adding structured data to content for enhanced SERP appearances.
---
plugin: seo
updated: 2026-01-20

# Schema Markup

## When to Use

- Adding structured data to content
- Implementing rich results
- Validating existing schema
- Planning schema strategy

## Common Schema Types

### Article/BlogPosting

```json
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Article Title (max 110 chars)",
  "image": ["https://example.com/image.jpg"],
  "author": {
    "@type": "Person",
    "name": "Author Name"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Publisher Name",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.jpg"
    }
  },
  "datePublished": "2025-01-01",
  "dateModified": "2025-01-15"
}
```

### FAQPage

```json
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Question text?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Answer text."
      }
    }
  ]
}
```

### HowTo

```json
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "How to do something",
  "step": [
    {
      "@type": "HowToStep",
      "name": "Step 1 title",
      "text": "Step 1 description"
    },
    {
      "@type": "HowToStep",
      "name": "Step 2 title",
      "text": "Step 2 description"
    }
  ]
}
```

## Implementation Checklist

- [ ] Use JSON-LD format (preferred by Google)
- [ ] Place in `<head>` or end of `<body>`
- [ ] Include all required properties
- [ ] Validate with Google Rich Results Test
- [ ] Test with Schema.org validator
- [ ] Check Search Console for errors

## Best Practices

1. **Be specific**: Use most specific type (BlogPosting over Article)
2. **Be accurate**: Only mark up visible content
3. **Be complete**: Include all required properties
4. **Test thoroughly**: Use validation tools
5. **Monitor**: Check Search Console regularly

Overview

This skill provides practical Schema.org markup implementation patterns to add structured data for enhanced search results. It focuses on common types like Article, FAQPage, and HowTo, and on implementation steps that lead to valid rich results. Use it to standardize schema across content and reduce validation errors.

How this skill works

The skill supplies JSON-LD patterns and a compact checklist for injecting structured data into pages. It inspects content requirements, recommends the most specific schema type, and guides placement and validation steps to ensure compatibility with Google Rich Results. It also outlines ongoing monitoring via Search Console and validators.

When to use it

Adding structured data to new or existing pages
Implementing or testing rich result eligibility
Validating and debugging schema markup
Planning a content-level schema strategy
Converting visible content into machine-readable form

Best practices

Prefer JSON-LD and place markup in the head or end of body
Select the most specific type available (e.g., BlogPosting over Article)
Only mark up content that is visible to users and accurately represented
Include all required properties for the chosen type
Validate with Google Rich Results Test and Schema.org validator before publishing
Monitor Search Console for schema errors and warnings

Example use cases

Add Article/BlogPosting markup to news articles to enable rich snippets
Create FAQPage markup for support or product pages to appear as FAQ rich results
Implement HowTo schema for instructional content to surface step-by-step snippets
Validate and fix existing schema flagged in Search Console to restore eligibility
Standardize schema patterns across a site to improve review speed and reduce errors

FAQ

Which format should I use for schema markup?

Use JSON-LD, as it is preferred by Google and easier to maintain without altering page markup.

Where should I place the JSON-LD block?

Place it in the document head or at the end of the body; both are supported, though head placement is common for consistent parsing.