Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
SEO Schema Writer
Write correct, validated, paste-ready JSON-LD for any page.
A production skill for Claude, by Avik Bal. Give it a page and it hands back the structured data you paste in, built from the real content on that page, tuned for two audiences at once: the Google rich results that still exist in 2026, and the entity signals that AI engines read to understand and cite you. Every run ends by telling you where to paste it and how to test it.
What's in this repo
| File | What it is |
|---|---|
seo-schema-writer.skill | The installable skill bundle. Upload this to Claude. |
seo-schema-writer-SKILL.md | The full skill with JSON-LD templates, readable in the browser. |
seo-schema-writer-README.md | The detailed reference, kept for depth. |
Install
Claude.ai
- Download
seo-schema-writer.skill. - Open Settings, then Capabilities, then Skills.
- Upload the file. It is ready in any chat.
Claude Code
- Create a folder
~/.claude/skills/seo-schema-writer/. - Save the skill inside it as
SKILL.md. - Start a session. The skill loads on a matching request.
Use it
Give it the real page and the real values. The more you provide, the more accurate the markup.
Starter prompts:
- "Write the foundation @graph for my site: Organization, WebSite, WebPage. Logo [url], link [LinkedIn, Wikidata]."
- "Generate BlogPosting schema for this post: [url]. Author [name, role], published [date]."
- "Write Product schema with the real price and our genuine rating: [details]."
- "Build DefinedTermSet schema from this glossary: [paste]."
- "Fix and re-validate the schema on [url] so it matches the visible content, then give me the test links."
What it writes
- Foundation entities for the whole site: Organization, WebSite, WebPage, and author Person, with stable
@idandsameAs. - Content markup: Article, BlogPosting, NewsArticle, with author, freshness, citations, and entity links.
- The GEO and AIO layer most tools skip:
sameAs,knowsAbout,about,mentions, DefinedTerm, QAPage, speakable, citation, andisBasedOn. - Commercial and vertical types: Product, Offer, Review, Service, SoftwareApplication, LocalBusiness, Event, JobPosting, Recipe, Video, Image.
- Breadcrumbs, and an honest read on FAQ and HowTo.
Current to 2026
Most schema tools still tell you to add FAQ markup for rich results. That is now wrong. Google retired FAQ rich results on May 7, 2026, HowTo earlier, and seven more types in June 2025. This skill knows the difference. It still writes FAQPage when the page has genuine question-and-answer content, because it helps machines and AI engines understand the page, but it tells you plainly that it no longer wins a SERP feature. You spend effort where a result still exists.
It tests itself
Every run closes with where to paste the block and the two links to validate it: the Rich Results Test and the Schema Markup Validator. You never leave guessing whether the markup works.
Part of the Growth Operating System
This is one module of Avik Bal's Growth Operating System, a suite of Claude skills for SEO, GEO, AEO, and SXO. For strategy and audits, pair it with the structured-data-engine module. Full suite: https://github.com/avikbal-dm/claude-seo-skills
Author
Avik Bal is a B2B digital marketing practitioner working in web architecture, SEO, content strategy, and marketing analytics. He is the author of CITED: The Growth Operating System for AI Search.
- LinkedIn: https://www.linkedin.com/in/avikbal/
- More skills: https://github.com/avikbal-dm
License
MIT. Copyright 2026 Avik Bal.