schema-markup

schema-markup is a skill for Claude Code from matteotitta/genesys-skills. It costs 125 tokens per session (2,388 once invoked), scanned A, original, MIT.

A tool for adding JSON-LD structured data to web pages. JSON-LD is machine-readable page information that can help search engines understand types such as products, articles, events, and reviews.

In plain words
What is it for?
Use it to generate page markup, combine several schema types, map pages to eligible rich results, and prepare validation checks.
Why use it?
It reduces the work of matching page data to the correct schema and checking whether the markup is valid.

Skill for Claude Code

Written for Claude Code: context: fork in frontmatter.

Needs its repository: it reads a path above its own folder, which exists only inside the repository. The line is Run `/premortem --output` before ship. See [`/premortem` skill](../../../../meta/orchestration/premortem/SKILL.md) for the 5 execution domains (will-it-resonate.

Good fit Use it to generate page markup, combine several schema types, map pages to eligible rich results, and prepare validation checks.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/matteotitta/genesys-skills
agentmods
npx agentmods add skills/matteotitta/genesys-skills/schema-markup

Made for: Claude Code.

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/matteotitta/genesys-skills/schema-markup/github.svg)](https://agentmods.dev/skills/matteotitta/genesys-skills/schema-markup)
Your own site
<a href="https://agentmods.dev/skills/matteotitta/genesys-skills/schema-markup"><img src="https://agentmods.dev/badge/skills/matteotitta/genesys-skills/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/matteotitta/genesys-skills/schema-markup"><img src="https://agentmods.dev/badge/skills/matteotitta/genesys-skills/schema-markup.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 125 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,388 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium Agent Snooping · line 197
    Skill enumerates or reads other installed skills. Access to other skills' SKILL.md files or the skills directory reveals prompt instructions, capabilities, and secrets that should be invisible to peer skills.
    Fix: Remove all code or instructions that list or read other skills' files or directories. Skills should operate independently; cross-skill access is a privilege escalation.
How audits are shown
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.00125 $0.02388
Opus 5 $0.00063 $0.01194
Sonnet 5 $0.00025 $0.00478
Haiku 4.5 $0.00013 $0.00239

Measured 9d ago against content hash 102015b1c253, 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 0 findings 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 9d 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/primitives/seo-aeo/execution/schema-markup/SKILL.md · 209 lines

How it starts

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

/schema-markup — JSON-LD generation + validation

Generate validated JSON-LD schema markup for a page (or batch of pages) based on the page type, available data, and target rich results. Output is paste-ready code plus a validation checklist.

This is a page-level execution skill, not a strategic SEO planning skill. Decide what content to produce via /aeo-strategy or /content-strategy first; this skill structures the markup once the content exists.


Doctrine inherited (Step 7 — 0626 rollout, locked 2026-06-04)

Output complies with output-tenets.md, output-simplicity.md, Step 6 calibration: see [[feedback_execution_doctrine_refinements_step6]].

Refinements applied to this skill (internal-reference floor):

Code Refinement How it lands in schema-markup
R1 Source placement JSON-LD output is structured data, not narrative — internal-reference. Schema property attribution stays inline.
R3 Product-update tone Skill-summary reports (validation pass/fail) frame as operator-direct.
R9 Action-oriented section names "Generate / Validate / Paste" — verb-led.

Note: internal-reference skill; R2/R5/R6/R7/R8 do not apply.


When to invoke

  • A page is shipping (new or refresh) and needs structured data before publish.
  • An audit found pages missing schema or with invalid markup.
  • A client is getting cited by AI engines (Perplexity, ChatGPT, Claude) but lacks validated schema to lock in eligibility.
  • A /aeo-content run is complete and you want the schema layer applied alongside.

Do NOT invoke when:

  • The page content doesn't exist yet (write copy first via /aeo-content or /landing-page-copy).
  • The audit is broader than schema (/website-audit covers crawlability, Core Web Vitals, on-page).

Workflow

Step 1 — Page-type assessment

Identify the page's content type. Match to schema.org type + eligible rich result:

Read the full file on GitHub · 209 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. 9d ago First seen · 209 lines · 125 tokens per session scan A 102015b1c253

Subscribe to this mod's changes

schema-markup is a skill published in the GitHub repository matteotitta/genesys-skills (36 stars, last pushed 1mo ago), licensed MIT. It adds 125 tokens to every session and 2,388 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

gingiris-b2b-growth

🇺🇸 B2B SaaS Growth — PLG vs SLG Playbook — Diagnose whether your problem is distribution, pricing, or PMF. PLG/SLG selection by ACV and sales cycle, the 5-stage path from $0 to $10M ARR, NRR discipline, affiliate & channel motion, enterprise tiering. Built from HeyGen, Deel, Vercel, Supabase, Snowflake patterns.…

Gingiris-1031/gingiris-skills · 484 tokens

gr-b2b-growth

A guide to growing a business-to-business software product from early user research to large-scale sales. B2B software is sold to companies rather than individual consumers.

Gingiris-1031/gingiris-skills · 83 tokens

go-to-market-playbook

A reusable Go-to-Market strategy template for both B2B and B2C launches. Covers positioning, messaging, ICP definition, channel selection, and competitive analysis frameworks. By @WeiYipei.

Gingiris-1031/gingiris-skills · 48 tokens

gingiris-go-global

🇺🇸 AI Product / SaaS Go-Global Complete SOP — From competitor research to launch to monetization. A full-cycle playbook covering Phase 0-5 (market validation, positioning, first 100 users, user interviews, beta-to-growth) plus open-source launch, Product Hunt, Reddit, SEO/GEO, conversion, and org principles.…

Gingiris-1031/gingiris-skills · 534 tokens

gr-competitor-research

Your competitor just launched. You have no idea how they grew so fast. Should you reverse-engineer their website? Track their social media? Map their growth flywheel? This gives you the complete SOP — from Wayback Machine snapshots to X/Twitter propagation analysis to growth flywheel scoring. Built from 150+ AI…

Gingiris-1031/gingiris-skills · 582 tokens

ai-launch-playbook

Launch your AI product to global attention — the playbook behind Manus, Devin, and AFFiNE's breakout launches. Covers AI-specific GTM strategy, hype cycle management, waitlist tactics, and multi-market rollout for maximum day-one impact.

Gingiris-1031/gingiris-skills · 54 tokens