How do I install the SEO Schema skill?

Run npx skillmds@latest add karvedconcepts/seo-schema in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is SEO Schema safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with SEO Schema?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is SEO Schema free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published SEO Schema?

karvedconcepts (@karvedconcepts) published this skill. Their other Agent Skills are listed on their SkillMD profile.

SEO Schema by karvedconcepts — Agent Skill

Name: SEO Schema
Author: karvedconcepts

SEO Schema

Shopify structured data audit sub-skill. Validates JSON-LD presence and correctness for Product, Organization, BreadcrumbList, and FAQ schema types. Use when user runs /seo schema or when seo-audit delegates schema checks.

File contents

SEO Schema Audit

Structured data sub-skill for Shopify stores. Validates JSON-LD presence and field completeness for Product, Organization, BreadcrumbList, and FAQPage schema types. Aggregates results by check across pages and reports a category score. Category weight: Schema = 15% (0.15) of overall SEO Health Score.

Quick Reference

Command	What it does
`/seo schema <url>`	Run structured data checks against a Shopify store
(via seo-audit)	seo-audit spawns audit-schema agent directly — this sub-skill is not used

Context Intake

This skill is invoked directly via /seo schema <url>.

When invoked directly:

If store URL not provided, read ~/.claude/skills/seo/profiles/karved.json and use preset
Run python3 ~/.claude/skills/seo/scripts/crawl_store.py <url> to generate crawl data before proceeding
Save output as seo-audit-crawl.json in the current directory
Then proceed to Execution Logic

Note: When invoked by seo-audit, this sub-skill is NOT used — seo-audit spawns the audit-schema agent directly.

Execution Logic

If invoked directly (not from seo-audit): a. If store URL not provided, read ~/.claude/skills/seo/profiles/karved.json and use preset b. Run python3 ~/.claude/skills/seo/scripts/crawl_store.py <url> to generate seo-audit-crawl.json
Spawn agent audit-schema via Task tool with prompt: "Run schema SEO audit on {store_url}. Crawl data at {cwd}/seo-audit-crawl.json"
Agent writes seo-schema-findings.md — present results to user

All check definitions, scoring logic, and output format are defined in the agent. If invoked by seo-audit, this sub-skill is NOT used — seo-audit spawns the agent directly.

Quality Gates

This skill inherits all quality gates from seo/SKILL.md. Do NOT redefine or soften them. The audit-schema agent applies severity levels locked by the quality gates.

Key inherited gates relevant to schema checks (for reference, not redefinition):

Missing Product schema on product pages = High (quality gate floor — actual check uses Critical for required field validation when Product schema is entirely absent, High when required offer fields are missing)

Reference Files

Load these on-demand as needed — do NOT load all at startup.

Path resolution: All references are installed at ~/.claude/skills/seo/references/.

references/scoring-system.md — Weighted scoring algorithm, severity multipliers (Critical=5.0, High=3.0, Medium=1.5, Low=0.5), grade thresholds. Schema category weight = 0.15.
references/schema-templates.md — JSON-LD templates with field validation checklists for Product, Organization, BreadcrumbList; Shopify Liquid field sources for each schema property

The agent loads its own references during execution.

---name: seo-schemadescription: Shopify structured data audit sub-skill. Validates JSON-LD presence and correctness for Product, Organization, BreadcrumbList, and FAQ schema types. Use when user runs /seo schema or when seo-audit delegates schema checks.---# SEO Schema AuditStructured data sub-skill for Shopify stores. Validates JSON-LD presence and field completenessfor Product, Organization, BreadcrumbList, and FAQPage schema types. Aggregates results by checkacross pages and reports a category score.Category weight: Schema = 15% (0.15) of overall SEO Health Score.## Quick Reference| Command | What it does ||---------|-------------|| `/seo schema <url>` | Run structured data checks against a Shopify store || (via seo-audit) | seo-audit spawns audit-schema agent directly — this sub-skill is not used |## Context IntakeThis skill is invoked directly via `/seo schema <url>`.**When invoked directly:**- If store URL not provided, read `~/.claude/skills/seo/profiles/karved.json` and use preset- Run `python3 ~/.claude/skills/seo/scripts/crawl_store.py <url>` to generate crawl data before proceeding- Save output as `seo-audit-crawl.json` in the current directory- Then proceed to Execution Logic**Note:** When invoked by seo-audit, this sub-skill is NOT used — seo-audit spawns the audit-schema agent directly.## Execution Logic1. If invoked directly (not from seo-audit): a. If store URL not provided, read `~/.claude/skills/seo/profiles/karved.json` and use preset b. Run `python3 ~/.claude/skills/seo/scripts/crawl_store.py <url>` to generate `seo-audit-crawl.json`2. Spawn agent `audit-schema` via Task tool with prompt: "Run schema SEO audit on {store_url}. Crawl data at {cwd}/seo-audit-crawl.json"3. Agent writes `seo-schema-findings.md` — present results to userAll check definitions, scoring logic, and output format are defined in the agent.If invoked by seo-audit, this sub-skill is NOT used — seo-audit spawns the agent directly.## Quality GatesThis skill inherits all quality gates from `seo/SKILL.md`. Do NOT redefine or soften them. The audit-schema agent applies severity levels locked by the quality gates.Key inherited gates relevant to schema checks (for reference, not redefinition):- Missing Product schema on product pages = High (quality gate floor — actual check uses Critical for required field validation when Product schema is entirely absent, High when required offer fields are missing)## Reference FilesLoad these on-demand as needed — do NOT load all at startup.**Path resolution:** All references are installed at `~/.claude/skills/seo/references/`.- `references/scoring-system.md` — Weighted scoring algorithm, severity multipliers (Critical=5.0, High=3.0, Medium=1.5, Low=0.5), grade thresholds. Schema category weight = 0.15.- `references/schema-templates.md` — JSON-LD templates with field validation checklists for Product, Organization, BreadcrumbList; Shopify Liquid field sources for each schema propertyThe agent loads its own references during execution.

Frequently asked questions