Schema Markup skill
The structured-data methodology Okara’s SEO Agent uses to add and validate JSON-LD so your pages qualify for rich results and search engines understand your entities.
Download the methodology, see how the agent plans markup, or run it live inside the SEO Agent.
- Category
- SEO
- Agent
- SEO Agent
- Format
- schema-markup.md
- Price
- Free to download
The skill file
--- name: schema-markup description: Add and validate structured data (JSON-LD) so pages qualify for rich results and search engines understand your entities. owner: Okara SEO Agent --- # Schema Markup Mark up your pages with structured data so search engines understand what they are — and so eligible pages win rich results that stand out in the SERP.
Log in to view, copy, and download the complete skill file.
About this skill
What is the Schema Markup?
The Schema Markup skill is the methodology Okara’s SEO Agent uses to add structured data to your pages so search engines understand exactly what they are — and so eligible pages earn rich results like stars, prices, and FAQs that make your listing stand out.
It’s written as a SKILL.md, a plain-language instruction format that people and AI agents can both follow. Read it to understand how schema types are matched to pages, filled, and validated, adapt it for your own stack, or let the SEO Agent plan and check markup for you.
Downloading the instructions is free with an Okara account. Running it continuously, with markup validated and kept error-free as templates change, is part of the SEO Agent.
Example
See it in action
You ask: “Competitors show review stars and prices in Google and we just show a plain link. How do we get those?”
Agent does: Those come from structured data your pages are missing. Your product pages have no Product or Offer markup, so Google has no price, availability, or rating to display — add valid Product JSON-LD with those fields and you become eligible for the same rich result. One caveat: only mark up ratings that actually appear on the page, or you risk a manual penalty. I’d add it at the product template level so every product gets it at once, then validate with the Rich Results Test before shipping.
How it works
From input to fix list
- 1
You provide the page and type
Share the URL and what the page is — product, article, FAQ, event, local business. Optionally add the data to reflect.
- 2
Okara matches schema to the page
The SEO Agent selects the schema types that fit and are eligible for a rich result, and checks any existing markup.
- 3
It plans complete JSON-LD
Required and recommended fields are filled with only on-page content, with entities connected via sameAs and @id.
- 4
You get validated markup
Each template gets a structured-data plan and validated JSON-LD, with errors flagged and fixed before shipping.
What's included
Everything it checks
JSON-LD generation
Produces structured data in JSON-LD, the format search engines prefer, per template.
Schema type selection
Matches Product, Article, FAQ, Event, and other types to the right pages.
Rich-result eligibility
Targets the markup that unlocks visible features like stars, prices, and FAQs.
Entity connections
Links your organization, products, and profiles with sameAs and @id references.
Validation
Tests every template against the Rich Results Test and a schema validator.
Error triage
Flags and prioritizes erroring markup that can silently disqualify a page.
Use cases
When to reach for it
- Win review stars, prices, or FAQ rich results your competitors already show.
- Add correct structured data to new product, article, or event pages.
- Fix schema errors that are quietly disqualifying pages from rich results.
- Strengthen how search engines understand your brand and entities.
- Roll out valid markup across a whole template instead of page by page.
Frequently asked questions
Related skills
Pair it with these skills
SEO
The full SEO operating loop Okara’s SEO Agent runs on autopilot: research, prioritize, ship, and measure, week after week.
--- name: seo description: Run end-to-end SEO for a website as a continuous loop: find opportunities, prioritize by impact, and ship on-page, technical, and content fixes. owner: Okara SEO Agent --- # SEO Operate SEO as a continuous loop rather than a one-off project: understand the site, find the highest-leverage opportunities, ship fixes, measure, repeat.
SEO Audit
A ready-to-run SEO audit skill: the exact methodology Okara’s SEO Agent uses to turn any URL into a prioritized, fix-ready report.
--- name: seo-audit description: Run a prioritized technical and on-page SEO audit of a web page and return the highest-impact fixes first, each with a copy-ready recommendation. owner: Okara SEO Agent --- # SEO Audit Audit a web page for technical, on-page, metadata, and structured-data issues, then return a short, prioritized list of fixes, not an undifferentiated dump
Technical SEO
The technical-foundations checklist Okara’s SEO Agent uses to keep a site crawlable, indexable, fast, and correctly marked up.
--- name: technical-seo description: Audit and fix the technical foundations of a site: crawlability, indexation, architecture, rendering, Core Web Vitals, and structured data. owner: Okara SEO Agent --- # Technical SEO Make sure search engines can crawl, render, and index your site correctly, then fix the technical issues that quietly cap your rankings.