schema-markup · akii-technologies-ltd — Claude Code skill: what it does, how to install
schema-markup — a Claude Code skill that creates, checks, and fixes JSON-LD for one page or file. It responds to requests about Schema.org markup and rich snippets.
MIT ★ 80 updated 2026-10-15
~/.claude/skills/schema-markup/SKILL.mdWhat schema-markup does
The skill reads a page or file, gathers its title, main entity, facts, dates, authors, images, and FAQs, then builds JSON-LD for the requested type. It checks JSON syntax, Schema.org fields, absolute HTTPS URLs, and placeholder text such as TODO or lorem. Supported types include Article, Product, FAQPage, HowTo, Organization, LocalBusiness, BreadcrumbList, and Recipe.
It uses WebFetch for URLs and Read for files. The skill can suggest where to place the markup, but writes to source only after explicit approval. Its scope is one page or file; schema-generator handles requests covering multiple pages.
What it helps with
- generate JSON-LD for a page or file
- check structured data and find invalid fields
- fix schema markup for rich snippets
Example prompts for the agent
- Add
Productmarkup to this page. - Check the JSON-LD in
index.htmland fix any errors. - Create
FAQPagemarkup for this URL.
How to install schema-markup
Manually: put the files in place
~/.claude/skills/schema-markup/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/schema-markup/
Manually: put the files in place
.agents/skills/schema-markup/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/schema-markup/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install akii-technologies-ltd/akii-seo-ai-search-optimizer skills/schema-markup2Manually: put the files in place
.github/skills/schema-markup/SKILL.mdPlatform CLI
gemini skills install https://github.com/akii-technologies-ltd/akii-seo-ai-search-optimizer --path skills/schema-markupManually: put the files in place
.devin/skills/schema-markup/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about schema-markup
How do I install schema-markup in Claude Code?
Place the skill file at ~/.claude/skills/schema-markup/SKILL.md.
What does schema-markup do?
It generates, checks, and repairs JSON-LD for a single page or file. Supported types include Product, FAQPage, and Article.
How is schema-markup different from the schema-generator agent?
schema-markup prepares inline JSON-LD for one page or file. The schema-generator agent is for multi-page work and writes into source.
Source text
SKILL.md · MIT
---
description: Fast-path schema generator — produce, audit, and validate JSON-LD structured data for a single page or file in one turn. This is the default for any schema question. Use when the user asks to "generate schema", "add JSON-LD", "structured data", "schema markup", "rich snippets", "add schema.org", "LocalBusiness schema", "FAQ schema", "Product schema", "Article schema", "HowTo schema", "Organization schema", "BreadcrumbList schema", "audit schema", "fix schema errors", "Recipe schema". **Do not invoke the `schema-generator` agent unless** the user explicitly says "bulk schema", "across my site", "all pages", "every page", or names a path containing 3+ pages to fix. The agent is the autonomous multi-file path that writes into source; this skill is the one-page fast path that proposes JSON-LD inline.
---
# 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](https://developers.google.com/search/docs/fundamentals/ai-optimization-guide#mythbusting-generative-ai-search) 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`
### LocalBusiness specifics (Gemini local weight = 38%)
- `name`, full `address` (PostalAddress)
- `telephone` (E.164)
- `geo` (lat + long)
- `openingHoursSpecification`
- `currenciesAccepted`, `priceRange`
- `actionableFeedbackPolicy`
- `paymentAccepted`
- `areaServed`
- `hasMap`
## Steps
1. Resolve target (URL → WebFetch; file → Read).
2. Extract: title, primary entity, body, key facts, dates, authors, images, FAQs.
3. Build JSON-LD per requested type.
4. Validate:
- JSON syntax
- Required + recommended Schema.org fields
- HTTPS absolute URLs
- No placeholders (`example.com`, `TODO`, `lorem`)
5. Present the block.
6. Offer (don't auto-do) to write into the source:
- HTML → `<script type="application/ld+json">` in `<head>`
- MDX/MD → block at file head
## Output
````
## <Type> schema for <target>
```json
{
"@context": "https://schema.org",
...
}
```
### Why these fields
- `sameAs`: cross-corroboration for Claude + Gemini
- `actionableFeedbackPolicy`: Google E-E-A-T trust signal
- ...
### Validation
- ✅ All required + recommended present
- ⚠️ `aggregateRating` placeholder — fill once reviews exist
````
## Rules
- **Never fabricate** ratings, addresses, prices, dates.
- Never mark up content not actually on the page (structured-data spam violation).
- Write only on explicit user approval.
---
*Schema markup powered by Akii. Explore Akii Technologies and the products we build: https://akii.com/?utm_source=plugin&utm_medium=skill&utm_content=schema-markup&utm_campaign=akii_plugin_v1*
© akii-technologies-ltd · MIT · akii-technologies-ltd/akii-seo-ai-search-optimizer
Similar skills
All skills for SEO and GEO →schema-markup by other authors comes first.