Schema Markup skill

The skill file

---
name: schema-markup
description: Add and validate structured data (JSON-LD) so pages qualify for rich results and are unambiguous to crawlers and AI.
owner: Moonrank SEO Agent
---

# Schema Markup

Structured data is how you stop making crawlers guess. A page with correct
JSON-LD qualifies for rich results, and reads unambiguously to the AI systems
that increasingly answer instead of Google. Wrong markup is worse than none:
it earns manual actions, not rich results.

## When to use
- Competitors show stars, prices, or FAQs in the SERP and you show a blue link.
- Products, articles, or events exist on the site with no machine-readable trace.
- AI assistants describe your business inaccurately because pages never state the facts.

## Inputs
- **Required:** the page templates in scope, and access to the rendered HTML.
- **Optional:** the entity facts — org details, product specs, author profiles — to mark up from one source of truth.

What is the Schema Markup skill?

The Schema Markup skill is how Moonrank's SEO Agent makes a site machine-readable: choosing the right schema.org type per template, generating JSON-LD from real page data, connecting entities into one graph, and validating everything before it ships.

It's written as a SKILL.md, a plain-language instruction format that people and AI agents can both follow. Read it to mark up your own templates, hand it to a developer as a spec, or let the SEO Agent generate and validate the blocks itself.

Downloading the playbook is free with a Moonrank account. Watching the enhancement reports and catching markup that silently breaks is what the SEO Agent does after every deploy.

See it in action

From input to fix list

1. 1

   You provide your templates

   The page types in scope and access to the rendered HTML, plus your entity facts if you have them centralized.

2. 2

   Moonrank maps content to types

   The agent picks the most specific schema.org type each template's content honestly supports.

3. 3

   It generates connected JSON-LD

   Blocks built from real page data, linked with @id so the site reads as one entity graph.

4. 4

   It validates and monitors

   Rich Results Test and schema.org validation before shipping, enhancement reports after.

Everything it checks

When to reach for it

• Qualify product pages for stars and price snippets in the SERP.
• Turn support content into FAQ rich results.
• Give AI assistants accurate, machine-readable facts about your business.
• Ship a developer a validated JSON-LD spec instead of a schema.org link.
• Find out why existing markup earns no rich results.

Frequently asked questions