How do I install the Schema Check skill?

Run npx skillmds@latest add rtk-ai/schema-check 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.

What does the Schema Check skill do?

Validate all JSON-LD scripts in Astro pages — check parsability, @context, @type, and Layout.astro auto-inject compatibility. It is listed under Web & Frontend on SkillMD.

Is Schema Check 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 Schema Check?

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 Schema Check free to use?

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

Who published Schema Check?

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

Schema Check by rtk-ai — Agent Skill

Name: Schema Check
Author: rtk-ai

File contents

Schema Check Skill

Extract and validate all <script type="application/ld+json"> blocks from Astro source files.

What to Check

Find all JSON-LD scripts in src/pages/**/*.astro and src/layouts/*.astro
For each script block:
- Is the JSON parseable? (JSON.parse() equivalent check)
- Does it have @context: "https://schema.org" at root?
- Does it have @type?
- If it's a @graph, do children NOT have @context?
Layout.astro auto-inject check:
- Layout.astro auto-injects a WebPage schema when it receives a simple schema object
- If a page passes a @graph object → Layout detects it and skips injection
- Verify: pages with @graph are NOT getting a duplicate WebPage from Layout
Schema type validation per page:
- / → expects @graph with Organization, SoftwareApplication, FAQPage, HowTo, WebPage
- /vox/, /icm/ → expects SoftwareApplication (Layout adds WebPage)
- /guide/* → BreadcrumbList + TechArticle (Starlight Head override)

Output Format

Page: src/pages/index.astro
  PASS: JSON parseable
  PASS: @context present at root
  PASS: @graph detected — Layout injection skipped
  FAIL: HowTo schema missing 'step' property

Page: src/pages/vox/index.astro
  PASS: JSON parseable
  PASS: SoftwareApplication schema correct
  WARN: No operatingSystem property (optional but recommended)

Report all issues with file + line reference where possible.

Frequently asked questions

Schema Check