content-reviewerlisted

**Canonical skill URI**: `skill://docs-tools:content-reviewer` # MDX Content Reviewer Review MDX files in `docs/` for errors that cause Astro/Starlight build failures. Report findings grouped by severity: **ERROR** (build-breaking), **WARNING** (likely issues), **INFO** (style suggestions). ## Scoping If the repository has recent uncommitted or staged changes, scope the review to changed MDX files only: ```bash git diff --name-only --diff-filter=ACMR HEAD -- 'docs/**/*.mdx' ``` If no changes exist or the user requests a full review, check all `docs/**/*.mdx` files. Use parallel tool calls throughout — read multiple files, run multiple Grep/Glob searches in a single turn wherever possible. ## Check 1: Frontmatter Validation Read each MDX file and parse the YAML block between the opening and closing `---` delimiters. **Regular pages** (any file except `docs/index.mdx`): | Field | Required | Type | Notes | | ------- | ---------- | ------ | ------- | | `title` | yes | string | Page title shown in browser tab and sidebar | | `sidebar.order` | yes | number | Controls sidebar sort order | | `sidebar.label` | recommended | string | Short label for sidebar (INFO if missing) | **Landing page** (`docs/index.mdx`): | Field | Required | Type | Notes | | ------- | ---------- | ------ | ------- | | `title` | yes | string | | | `template` | yes | `splash` | Must be the literal string `splash` | | `hero.title` | yes | string | | | `hero.tagline` | yes | string | | | `hero.image.h