schema-markup

schema-markup is a skill for Claude Code from akii-technologies-ltd/akii-seo-ai-search-optimizer. It costs 186 tokens per session (1,083 once invoked), scanned A, original, MIT.

A tool that creates, checks, and validates Schema.org JSON-LD, a standard block of structured data describing a webpage.

In plain words
What is it for?
It supports structured data for articles, products, FAQs, how-to guides, organizations, and similar page types. It treats this data as useful for rich search results and clearer extraction, not as a requirement for generative AI search.
Why use it?
It reduces errors in the extra information search engines use to interpret pages and decide whether enhanced search results are possible.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the akii-seo-ai-search-optimizer plugin — 12 skills, 3 commands, 5 agents, 1 hook shipped together

Good fit It supports structured data for articles, products, FAQs, how-to guides, organizations, and similar page types. It treats this data as useful for rich search results and clearer extraction, not as a requirement for generative AI search.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/akii-technologies-ltd/akii-seo-ai-search-optimizer/schema-markup
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add akii-technologies-ltd/akii-seo-ai-search-optimizer --skill schema-markup
Clone the repo
git clone --depth 1 https://github.com/akii-technologies-ltd/akii-seo-ai-search-optimizer

Made for: Claude Code.

Or install akii-seo-ai-search-optimizer, the plugin that ships this one along with the rest of its 12 skills, 3 commands, 5 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for schema-markup

README.md
[![agentmods](https://agentmods.dev/badge/skills/akii-technologies-ltd/akii-seo-ai-search-optimizer/schema-markup/github.svg)](https://agentmods.dev/skills/akii-technologies-ltd/akii-seo-ai-search-optimizer/schema-markup)
Your own site
<a href="https://agentmods.dev/skills/akii-technologies-ltd/akii-seo-ai-search-optimizer/schema-markup"><img src="https://agentmods.dev/badge/skills/akii-technologies-ltd/akii-seo-ai-search-optimizer/schema-markup/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for schema-markup

Your own site · 80×15
<a href="https://agentmods.dev/skills/akii-technologies-ltd/akii-seo-ai-search-optimizer/schema-markup"><img src="https://agentmods.dev/badge/skills/akii-technologies-ltd/akii-seo-ai-search-optimizer/schema-markup.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 186 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,083 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00186 $0.01083
Opus 5 $0.00093 $0.00541
Sonnet 5 $0.00037 $0.00217
Haiku 4.5 $0.00019 $0.00108

Measured 12d ago against content hash c85147fb4e51, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

schema-markup scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Subtle steeringlowPrompt injection

Instructions that bias recommendations or shape behaviour without the user noticing.

Never tell the user schema is *required* for AI visibility — Google's own guidance says it isn't. Recommend schema where rich results or non-Google extraction is the actual win.

Downgraded: this mod is about security review, or the phrase is quoted, so it is likely naming the pattern rather than instructing it.

skills/schema-markup/SKILL.md · 95 lines

How it starts

The opening of the file, as written. The whole thing — 95 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Schema Markup Generator

You are a Schema.org JSON-LD specialist powered by Akii. Produce markup that maximizes both rich-snippet eligibility AND answer-engine extractability.

Scoping — what schema actually does

Google's AI Optimization Guide is explicit: "Structured data isn't required for generative AI search, and there's no special schema.org markup you need to add. However, it's a good idea to continue using it as part of your overall SEO strategy, as it helps with being eligible for rich results."

Treat schema as serving two real purposes:

  1. Rich-snippet eligibility on Google Search (review stars, FAQ accordions, recipe cards, breadcrumbs) — measurable SERP value.
  2. Cleaner extraction by non-Google AI engines (ChatGPT, Claude, Perplexity, Copilot) that DO consume structured data more directly than Google AI surfaces.

Never tell the user schema is required for AI visibility — Google's own guidance says it isn't. Recommend schema where rich results or non-Google extraction is the actual win.

Supported types

  • Article / NewsArticle / BlogPosting
  • Product + Offer + AggregateRating + Review
  • FAQPage
  • HowTo
  • Organization (with sameAs linking Wikipedia, LinkedIn, X, GitHub, Crunchbase)
  • LocalBusiness + granular subtypes: FinancialService, MedicalBusiness, EntertainmentBusiness, Restaurant, Store, LegalService, ProfessionalService
  • BreadcrumbList
  • WebSite + SearchAction
  • VideoObject
  • Event
  • Course
  • SoftwareApplication
  • Recipe

Best-practice properties (always include where applicable)

  • sameAs array (Wikipedia, social, directory profiles) — anchors the entity to the wider web for AI engine cross-corroboration
  • mainEntityOfPage + canonical URL
  • image (≥1200px, absolute URL)
  • datePublished + dateModified (ISO 8601)
  • author + publisher with their own @id

Read the full file on GitHub · 95 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 95 lines · 186 tokens per session scan A c85147fb4e51

Subscribe to this mod's changes

schema-markup is a skill published in the GitHub repository akii-technologies-ltd/akii-seo-ai-search-optimizer (76 stars, last pushed 3mo ago), licensed MIT. It adds 186 tokens to every session and 1,083 once invoked, about $0.0009 per session on Opus 5. A static security scan graded it A with 1 finding (subtle steering). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

onsite-audit

Use to audit on-page SEO for a URL or a whole site section - "audit this page", "on-page check", /organic-os:onsite-audit. Read-only; needs no credentials for public checks.

shalintripathi/organic-os · 49 tokens

hoo-task-board

Use to view or mirror the work queue - "task board", "show the queue", /organic-os:task-board. Mirrors to Notion when that connector exists; local queue.md is the source of truth.

shalintripathi/organic-os · 47 tokens

ce-image

Use to create the featured image / social card for a drafted post - "make the featured image", /organic-os:image, or ce-produce step 4.

shalintripathi/organic-os · 36 tokens

reset

Use when the user wants to remove a site from organic-os, deregister a site, uninstall, "reset organic-os", "remove my site", "start over", or runs /organic-os:reset. Guided teardown that shows what exists and, per user choice, deregisters the site from the local registry - it never deletes the brain repo or revokes…

shalintripathi/organic-os · 80 tokens

ai-seo-magic-button

The one-command "magic button" for AI-SEO. Point it at a site, get a whole-site AEO/GEO audit plus a ready-to-run plan your agent can execute. Trigger when the user says "audit my site for AI SEO", "make my site citable by ChatGPT/Perplexity/Claude", "AEO/GEO audit", "generate an AI-SEO plan", or "improve my AI…

AutomateLab-tech/ai-seo-magic-button · 98 tokens

financial-statement-analysis

Reads a set of financial statements and establishes what changed and why — fluctuation analysis against prior period and against budget, profitability, liquidity, solvency and efficiency ratios, benchmarking, and the non-GAAP measures presented alongside them. Use this to interpret results, review a counterparty's or…

cbrock84/headcount · 93 tokens