# Schema Check

> Validate all JSON-LD scripts in Astro pages — check parsability, @context, @type, and Layout.astro auto-inject compatibility.

- Skill: `rtk-ai/schema-check` (Agent Skill)
- Install (CLI): `npx skillmds@latest add rtk-ai/schema-check`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rtk-ai/schema-check/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: rtk-ai (https://skillmd.com/u/rtk-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rtk-ai/schema-check

---


# Schema Check Skill

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

## What to Check

1. **Find all JSON-LD scripts** in `src/pages/**/*.astro` and `src/layouts/*.astro`

2. **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`?

3. **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

4. **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.