Agent skill

SEO Schema

by AgriciDaniel in AgriciDaniel/codex-seo

Detect, validate, and generate Schema.org structured data. An agent skill from AgriciDaniel/codex-seo.

Install SEO Schema

skills CLI

$ npx skills add AgriciDaniel/codex-seo --skill seo-schema -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install AgriciDaniel/codex-seo seo-schema --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/AgriciDaniel/codex-seo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-schema .claude/skills/seo-schema && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "seo-schema" agent skill from https://github.com/AgriciDaniel/codex-seo/tree/main/skills/seo-schema into .claude/skills/seo-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "seo-schema", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/AgriciDaniel/codex-seo/tree/main/skills/seo-schema

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add AgriciDaniel/codex-seo --skill seo-schema -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install AgriciDaniel/codex-seo seo-schema --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/AgriciDaniel/codex-seo.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/seo-schema .agents/skills/seo-schema && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "seo-schema" agent skill from https://github.com/AgriciDaniel/codex-seo/tree/main/skills/seo-schema into .agents/skills/seo-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "seo-schema", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add AgriciDaniel/codex-seo --skill seo-schema -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install AgriciDaniel/codex-seo seo-schema --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/AgriciDaniel/codex-seo.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/seo-schema .cursor/skills/seo-schema && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "seo-schema" agent skill from https://github.com/AgriciDaniel/codex-seo/tree/main/skills/seo-schema into .cursor/skills/seo-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "seo-schema", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/AgriciDaniel/codex-seo.git --path skills/seo-schema

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add AgriciDaniel/codex-seo --skill seo-schema -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install AgriciDaniel/codex-seo seo-schema --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/AgriciDaniel/codex-seo.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/seo-schema .gemini/skills/seo-schema && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "seo-schema" agent skill from https://github.com/AgriciDaniel/codex-seo/tree/main/skills/seo-schema into .gemini/skills/seo-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "seo-schema", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install AgriciDaniel/codex-seo seo-schema

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add AgriciDaniel/codex-seo --skill seo-schema -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/AgriciDaniel/codex-seo.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/seo-schema .github/skills/seo-schema && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "seo-schema" agent skill from https://github.com/AgriciDaniel/codex-seo/tree/main/skills/seo-schema into .github/skills/seo-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "seo-schema", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add AgriciDaniel/codex-seo --skill seo-schema -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install AgriciDaniel/codex-seo seo-schema --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/AgriciDaniel/codex-seo.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/seo-schema .opencode/skills/seo-schema && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "seo-schema" agent skill from https://github.com/AgriciDaniel/codex-seo/tree/main/skills/seo-schema into .opencode/skills/seo-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "seo-schema", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: seo-schema
GitHub stars: 797
Used in: 5 other repos
Token cost: ~1.6k tokens
SKILL.md length: 565 words
Files: 2
Skills in repo: 18
Repo updated: Sep 11, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Detect, validate, and generate Schema.org structured data. An agent skill from AgriciDaniel/codex-seo.

Works in 4 steps: Scan page source for JSON-LD → Check for Microdata (itemscope, itemprop) → Check for RDFa (typeof, property) → …
User says schema
SKILL.md covers Shared Data Cache, Detection, Validation and Schema Type Status (as of Feb…, plus 5 more sections
Reaches schema.org

What it does

SEO Schema is an agent skill from AgriciDaniel/codex-seo. Detect, validate, and generate Schema.org structured data. JSON-LD format preferred. Use when user says "schema", "structured data", "rich results", "JSON-LD", or "markup".

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file.

It sits in Marketing & SEO, covering Schema markup. The repository describes itself as: Codex-first SEO skill suite. 26 workflows, 24 TOML agents, DataForSEO/Gemini/Google/Firecrawl integrations, GEO/AEO, CWV, schema, backlinks, local/maps, and deterministic reports. The licence is MIT.

When your agent uses it

User says schema
Structured data

Example prompts

“schema”
“structured data”
“rich results”
“/seo-schema”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

Scan page source for JSON-LD
Check for Microdata (itemscope, itemprop)
Check for RDFa (typeof, property)
Always recommend JSON-LD as primary format (Google's stated preference)

What it can do on your machine

Read from SKILL.md and the folder at commit 9a644f6. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are json).
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- schema.org
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

SEO Schema loads about 1.6k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 565 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~46
When it runs · the whole SKILL.md, loaded when a task matches: ~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AgriciDaniel/codex-seo at commit 9a644f6, republished under its MIT licence (© AgriciDaniel). 565 words, ~1,603 tokens.

Download SKILL.mdSave it as .claude/skills/seo-schema/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: seo-schema
description: Detect, validate, and generate Schema.org structured data. JSON-LD format preferred. Use when user says "schema", "structured data", "rich results", "JSON-LD", or "markup".
user-invokable: true
argument-hint: [url]
license: MIT
metadata.author: AgriciDaniel
metadata.version: 1.9.6
metadata.category: seo

Schema Markup Analysis & Generation

Shared Data Cache

Step 0 -- Check shared data cache:

Before gathering, check .seo-cache/ for reusable context from related SEO skills. Reference: ../seo/references/shared-data-cache.md for schemas and dependency map.

Check these cache files when present:

.seo-cache/site-meta.json for domain, business type, industry, and crawl context
.seo-cache/audit-scores.json for prior full-audit priorities
.seo-cache/pages/{url-slug}/page-analysis.json for page-level context when a URL is provided
If found: parse and use clearly valid fields (note "Using cached [X] from [date]")
If missing, corrupt, or irrelevant: continue with fresh evidence
If the user says "refresh" or "re-run": ignore cache reads and overwrite on write

Detection

Scan page source for JSON-LD <script type="application/ld+json">
Check for Microdata (itemscope, itemprop)
Check for RDFa (typeof, property)
Always recommend JSON-LD as primary format (Google's stated preference)

Validation

Check required properties per schema type
Validate against Google's supported rich result types
Test for common errors:
- Missing @context
- Invalid @type
- Wrong data types
- Placeholder text
- Relative URLs (should be absolute)
- Invalid date formats
Flag deprecated types (see below)

Schema Type Status (as of Feb 2026)

Read references/schema-types.md for the full list. Key rules:

Organization, LocalBusiness, SoftwareApplication, WebApplication, Product (with Certification markup as of April 2025), ProductGroup, Offer, Service, Article, BlogPosting, NewsArticle, Review, AggregateRating, BreadcrumbList, WebSite, WebPage, Person, ProfilePage, ContactPage, VideoObject, ImageObject, Event, JobPosting, Course, DiscussionForumPosting

BroadcastEvent, Clip, SeekToAction, SoftwareSourceCode

See schema/templates.json for ready-to-use JSON-LD templates for these types.

JSON-LD and JavaScript rendering: Per Google's December 2025 JS SEO guidance, structured data injected via JavaScript may face delayed processing. For time-sensitive markup (especially Product, Offer), include JSON-LD in the initial server-rendered HTML.

RESTRICTED (only for specific sites):

FAQ: ONLY for government and healthcare authority sites (restricted Aug 2023)

HowTo: Rich results removed September 2023
SpecialAnnouncement: Deprecated July 31, 2025
CourseInfo, EstimatedSalary, LearningVideo: Retired June 2025
ClaimReview: Retired from rich results June 2025
VehicleListing: Retired from rich results June 2025
Practice Problem: Retired from rich results late 2025
Dataset: Retired from rich results late 2025
Book Actions: Deprecated then reversed, still functional as of Feb 2026 (historical note)

Show full SKILL.md (219 more words)Show less

Generation

When generating schema for a page:

Identify page type from content analysis
Select appropriate schema type(s)
Generate valid JSON-LD with all required + recommended properties
Include only truthful, verifiable data. Use placeholders clearly marked for user to fill
Validate output before presenting

Common Schema Templates

Organization

json

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "[Company Name]",
  "url": "[Website URL]",
  "logo": "[Logo URL]",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "[Phone]",
    "contactType": "customer service"
  },
  "sameAs": [
    "[Facebook URL]",
    "[LinkedIn URL]",
    "[Twitter URL]"
  ]
}

LocalBusiness

json

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "[Business Name]",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "[Street]",
    "addressLocality": "[City]",
    "addressRegion": "[State]",
    "postalCode": "[ZIP]",
    "addressCountry": "US"
  },
  "telephone": "[Phone]",
  "openingHours": "Mo-Fr 09:00-17:00",
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": "[Lat]",
    "longitude": "[Long]"
  }
}

Article/BlogPosting

json

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "[Title]",
  "author": {
    "@type": "Person",
    "name": "[Author Name]"
  },
  "datePublished": "[YYYY-MM-DD]",
  "dateModified": "[YYYY-MM-DD]",
  "image": "[Image URL]",
  "publisher": {
    "@type": "Organization",
    "name": "[Publisher]",
    "logo": {
      "@type": "ImageObject",
      "url": "[Logo URL]"
    }
  }
}

Output

SCHEMA-REPORT.md: detection and validation results
generated-schema.json: ready-to-use JSON-LD snippets

Validation Results

Schema	Type	Status	Issues
...	...	✅/⚠️/❌	...

Recommendations

Missing schema opportunities
Validation fixes needed
Generated code for implementation

Error Handling

Scenario	Action
URL unreachable	Report connection error with status code. Suggest verifying URL and checking if the page requires authentication.
No schema markup found	Report that no JSON-LD, Microdata, or RDFa was detected. Recommend appropriate schema types based on page content analysis.
Invalid JSON-LD syntax	Parse and report specific syntax errors (missing brackets, trailing commas, unquoted keys). Provide corrected JSON-LD output.
Deprecated schema type detected	Flag the deprecated type with its retirement date. Recommend the current replacement type or advise removal if no replacement exists.

Write to shared data cache

After completing all work, write a concise JSON summary to .seo-cache/ when the workflow produced durable findings. Use the schemas and naming rules in ../seo/references/shared-data-cache.md; include at least cache_type, analyzed_at, source URL/domain, key findings, issues, recommendations, and tool limitations. Add .seo-cache/ to .gitignore if it is missing.

Files

SKILL.md and 1 other file in skills/seo-schema of AgriciDaniel/codex-seo.

SKILL.md
LICENSE.txt

Open the folder on GitHubat commit 9a644f6

Used in 6 other repositories

We found 17 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in AgriciDaniel/codex-seo, which our catalogue first saw on October 7, 2026.

Compare with similar skills

SEO Schema next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

SEO Schema compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
SEO Schema this skillAgriciDaniel/codex-seo	797	5 repos	~1.6k	Automated safety check: Pass	MIT	27 days ago
SEO GeoReScienceLab/opc-skills	1.8k	4 repos	~2.1k	Automated safety check: Pass	Apache-2.0	yesterday
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude	11k	—	~2.8k	Automated safety check: Notes	MIT	today
SEO Optimizerailabs-393/ai-labs-claude-skills	454	1 repos	~3.2k	Automated safety check: Pass	MIT	11 mo ago
Portaljs Add Dcatdatopian/portaljs	2.4k	1 repos	~1.8k	Automated safety check: Pass	MIT	yesterday
Schema Markupfreekmurze/dotfiles	1k	15 repos	~1.2k	Automated safety check: Pass	None	yesterday

Similar skills

SEO Geo
ReScienceLab/opc-skills
SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.
1.8k GitHub starsUsed in 4 repos~2.1k tokens
Marketing & SEOAuto-check passed
GEO-First SEO Audit Tool
zubair-trabzada/geo-seo-claude
Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.
11k GitHub stars~2.8k tokensUpdated today
Marketing & SEOAuto-check: notes
SEO Optimizer
ailabs-393/ai-labs-claude-skills
This skill should be used when analyzing HTML/CSS websites for SEO optimization, fixing SEO issues, generating SEO reports, or implementing SEO best practices.
454 GitHub starsUsed in 1 repo~3.2k tokens
Marketing & SEOAuto-check passed
Portaljs Add Dcat
datopian/portaljs
Make a PortalJS portal harvestable by national/EU/US open-data portals — emit standards-compliant DCAT catalog feeds (DCAT 2/3, DCAT-AP, DCAT-US, national profiles) in JSON-LD, Turtle, and RDF/XML…
2.4k GitHub starsUsed in 1 repo~1.8k tokens
Marketing & SEOAuto-check passed
Schema Markup
freekmurze/dotfiles
When the user wants to add, fix, or optimize schema markup and structured data on their site.
1k GitHub starsUsed in 15 repos~1.2k tokens
Marketing & SEOAuto-check passed
Geo
liangdabiao/GEO-Content-Optimizer-Skill
完整的 GEO（生成式引擎优化）服务流水线：给一个产品官网 URL 和介绍材料，做站点诊断与 AI 答案采样、生成带验收标准的执行工单、产出可直接部署的资产（llms.txt / JSON-LD / 定义块 / FAQ / 内容大纲与初稿）、自动验收工单是否闭环、并打包成可直接发给客户的交付物。可按周期复跑，做长期 GEO 运营与月报。
205 GitHub starsUsed in 1 repo~2.3k tokens
Marketing & SEOAuto-check: notes

Questions about SEO Schema

What does SEO Schema do?

Detect, validate, and generate Schema.org structured data. An agent skill from AgriciDaniel/codex-seo. SEO Schema is an agent skill from AgriciDaniel/codex-seo.org structured data.

When should I use SEO Schema?

SEO Schema fits situations like: user says schema; structured data.

How do I install SEO Schema in Claude Code?

Run `npx skills add AgriciDaniel/codex-seo --skill seo-schema -a claude-code`. Or copy the skill folder (skills/seo-schema in AgriciDaniel/codex-seo) into .claude/skills/seo-schema in your project. Claude Code loads it when a task matches its description.

How do I install SEO Schema in Codex?

Run `npx skills add AgriciDaniel/codex-seo --skill seo-schema -a codex`. Or copy the skill folder (skills/seo-schema in AgriciDaniel/codex-seo) into .agents/skills/seo-schema in your project. Codex loads it when a task matches its description.

Can I use SEO Schema in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AgriciDaniel/codex-seo --skill seo-schema -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-schema, .gemini/skills/seo-schema, .github/skills/seo-schema and .opencode/skills/seo-schema in your project.

What does SEO Schema need to run?

SKILL.md names no scripts, command-line tools or credentials: SEO Schema is instructions for the agent only.

Does SEO Schema access the network?

SKILL.md names 1 domain. In commands or code: schema.org; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is SEO Schema safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does SEO Schema use?

SEO Schema is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO Schema use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to SEO Schema?

Skills that share tags, products or a category with SEO Schema: SEO Geo (ReScienceLab/opc-skills, 1.8k stars), GEO-First SEO Audit Tool (zubair-trabzada/geo-seo-claude, 11k stars), SEO Optimizer (ailabs-393/ai-labs-claude-skills, 454 stars) and Portaljs Add Dcat (datopian/portaljs, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Schema?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/codex-seo, which has 797 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on September 11, 2026.

Source: AgriciDaniel/codex-seo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install SEO Schema

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Schema Markup Analysis & Generation

Shared Data Cache

Detection

Validation

Schema Type Status (as of Feb 2026)

ACTIVE (recommend freely):

VIDEO & SPECIALIZED (recommend freely):

RESTRICTED (only for specific sites):

DEPRECATED (never recommend):

Generation

Common Schema Templates

Organization

LocalBusiness

Article/BlogPosting

Output

Validation Results

Recommendations

Error Handling

Write to shared data cache

Files

Used in 6 other repositories

Compare with similar skills

Similar skills

More from AgriciDaniel/codex-seo

Related

Questions about SEO Schema