# Schema Markup Expert

> Easily add and optimize schema markup for Google rich results like star ratings, FAQs, and breadcrumbs.

- Canonical: https://nanoskill.ai/id/skills/schema-markup-expert-skill
- Markdown: https://nanoskill.ai/id/skills/schema-markup-expert-skill.md
- Author: coreyhaines31
- Published: 2026-09-15T02:00:00.000Z
- Updated: 2026-09-15T07:14:03.770Z
- Language: id
- Source type: github
- Popularity signal: 41252

## Sources

- https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema

## Install

```shell
npx skills add https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema
```

## About

Schema markup is the key to unlocking rich results in Google Search. The Schema Markup Expert skill makes it effortless to add, fix, and optimize structured data on your site, from JSON-LD implementation to validation. It helps marketers, developers, and SEO specialists achieve enhanced search visibility by providing accurate, Google-compliant markup that powers star ratings, FAQs, breadcrumbs, and more.

Unlike basic generators, this skill follows Google's guidelines precisely, supports dozens of schema types including Article, Product, FAQ, and HowTo, and can combine multiple types using @graph for comprehensive markup. It ensures accuracy by mapping schema to page content and validating with industry-standard tools, so you deploy only error-free, rich-result-ready code.

Whether you run a blog looking for FAQ snippets, an e-commerce store needing product stars, or a local business wanting a Knowledge Panel, this skill provides ready-to-use templates and step-by-step guidance. It integrates into any tech stack, from static HTML to Next.js and WordPress, making schema markup accessible for every project.

## Key features

- **Rich Snippet Generation**: Produce schema markup that qualifies for Google rich results like star ratings, FAQs, and breadcrumbs.
- **JSON-LD Format**: Implement schema using JSON-LD, the format recommended by Google for easy integration into any page.
- **Comprehensive Type Support**: From Article and Product to HowTo and Event, mark up any content type with the right schema.org vocabulary.
- **Automated Validation**: Test schema against Google’s Rich Results Test and Schema.org validator to catch errors before deployment.
- **Flexible Implementation**: Add schema to static HTML, JavaScript frameworks, or CMS platforms like WordPress with minimal code changes.

## Use cases

- **Boost CTR with FAQ Rich Results**: Content teams can add FAQ schema to pages, enabling expandable Q&A in search results and increasing click-through rates.
- **Show Product Details in Search**: E-commerce managers can implement product schema to display star ratings, price, and availability directly in Google.
- **Fix Schema Errors at Scale**: SEO specialists can validate and correct structured data issues across large sites, restoring rich result eligibility.
- **Enhance Brand Knowledge Panels**: Brand managers can deploy Organization schema with social profiles to improve Google Knowledge Panel accuracy.

## Result preview

See a complete schema audit and optimization strategy for NanoSkill, including structured data recommendations, JSON-LD implementation, and rich results optimization generated by this Agent Skill.

![the demo of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-demo-1.png)

![the demo of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-demo-2.png)

![the demo of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-demo-3.png)

![the demo of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-demo-4.png)

## Result walkthrough

### Install

Add the Schema Markup Skill to your AI agent.

![the first step of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-step-1.png)

### Describe Task

Provide your website URL, page type, and schema optimization goals.

![the second step of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-step-2.png)

### Get Schema Audit

Get structured data recommendations, JSON-LD implementation, and rich results optimization guidance.

![the third step of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-step-3.png)

## Skill definition

# Schema Markup

You are an expert in structured data and schema markup. Your goal is to implement schema.org markup that helps search engines understand content and enables rich results in search.

## Initial Assessment

**Check for product marketing context first:**
If `.agents/product-marketing.md` exists (or `.claude/product-marketing.md`, or the legacy `product-marketing-context.md` filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.

Before implementing schema, understand:

1. **Page Type** - What kind of page? What's the primary content? What rich results are possible?

2. **Current State** - Any existing schema? Errors in implementation? Which rich results already appearing?

3. **Goals** - Which rich results are you targeting? What's the business value?

---

## Core Principles

### 1. Accuracy First
- Schema must accurately represent page content
- Don't markup content that doesn't exist
- Keep updated when content changes

### 2. Use JSON-LD
- Google recommends JSON-LD format
- Easier to implement and maintain
- Place in `<head>` or end of `<body>`

### 3. Follow Google's Guidelines
- Only use markup Google supports
- Avoid spam tactics
- Review eligibility requirements

### 4. Validate Everything
- Test before deploying
- Monitor Search Console
- Fix errors promptly

---

## Common Schema Types

| Type | Use For | Required Properties |
|------|---------|-------------------|
| Organization | Company homepage/about | name, url |
| WebSite | Homepage (search box) | name, url |
| Article | Blog posts, news | headline, image, datePublished, author |
| Product | Product pages | name, image, offers |
| SoftwareApplication | SaaS/app pages | name, offers |
| FAQPage | FAQ content | mainEntity (Q&A array) |
| HowTo | Tutorials | name, step |
| BreadcrumbList | Any page with breadcrumbs | itemListElement |
| LocalBusiness | Local business pages | name, address |
| Event | Events, webinars | name, startDate, location |

**For complete JSON-LD examples**: See [references/schema-examples.md](references/schema-examples.md)

---

## Quick Reference

### Organization (Company Page)
Required: name, url
Recommended: logo, sameAs (social profiles), contactPoint

### Article/BlogPosting
Required: headline, image, datePublished, author
Recommended: dateModified, publisher, description

### Product
Required: name, image, offers (price + availability)
Recommended: sku, brand, aggregateRating, review

### FAQPage
Required: mainEntity (array of Question/Answer pairs)

### BreadcrumbList
Required: itemListElement (array with position, name, item)

---

## Multiple Schema Types

You can combine multiple schema types on one page using `@graph`:

```json
{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "Organization", ... },
    { "@type": "WebSite", ... },
    { "@type": "BreadcrumbList", ... }
  ]
}
```

---

## Validation and Testing

### Tools
- **Google Rich Results Test**: https://search.google.com/test/rich-results
- **Schema.org Validator**: https://validator.schema.org/
- **Search Console**: Enhancements reports

### Common Errors

**Missing required properties** - Check Google's documentation for required fields

**Invalid values** - Dates must be ISO 8601, URLs fully qualified, enumerations exact

**Mismatch with page content** - Schema doesn't match visible content

---

## Implementation

### Static Sites
- Add JSON-LD directly in HTML template
- Use includes/partials for reusable schema

### Dynamic Sites (React, Next.js)
- Component that renders schema
- Server-side rendered for SEO
- Serialize data to JSON-LD

### CMS / WordPress
- Plugins (Yoast, Rank Math, Schema Pro)
- Theme modifications
- Custom fields to structured data

---

## Output Format

### Schema Implementation
```json
// Full JSON-LD code block
{
  "@context": "https://schema.org",
  "@type": "...",
  // Complete markup
}
```

### Testing Checklist
- [ ] Validates in Rich Results Test
- [ ] No errors or warnings
- [ ] Matches page content
- [ ] All required properties included

---

## Task-Specific Questions

1. What type of page is this?
2. What rich results are you hoping to achieve?
3. What data is available to populate the schema?
4. Is there existing schema on the page?
5. What's your tech stack?

## FAQ

### What is schema markup?

Schema markup is structured data added to web pages to help search engines understand content and enable rich results like star ratings, FAQs, and products.

### How do I add schema markup to my site?

You can add schema markup using JSON-LD code placed in the head of your page, a CMS plugin, or a JavaScript framework component.

### Which schema type should I use for my blog?

For blog posts, use Article or BlogPosting schema with headline, image, datePublished, and author properties.

### Will schema markup improve my rankings?

While schema markup is not a direct ranking factor, it enhances rich results which can improve click-through rates and search visibility.

### Is there a free tool to validate schema?

Yes, Google's Rich Results Test and Schema.org validator are free and recommended for testing your markup.

### Can I combine multiple schema types on one page?

Absolutely, you can use @graph in JSON-LD to combine types like Organization and BreadcrumbList for more comprehensive representation.