moai-ref-seo

Reviews web pages for canonical URLs, metadata uniqueness, JSON-LD consistency, and crawlability.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/taewook486/Masters_degree --skill moai-ref-seo-taewook486
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: moai-ref-seo
Source: https://github.com/taewook486/Masters_degree/tree/main/.claude/skills/moai-ref-seo
Command: npx skills add https://github.com/taewook486/Masters_degree --skill moai-ref-seo-taewook486

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Web pages often fail to be indexed correctly because of duplicate canonical addresses, reused titles and meta descriptions, hardcoded hosts in robots.txt and sitemap.xml, and JSON-LD structured data that contradicts the visible page. This Skill provides a reference of decision rules and verification checklists to catch those defects before shipping. ## Core Features & Use Cases - Canonical and Identity Rules: Enforces one address per resource, redirect discipline for trailing slashes and parameters, and declarations that match the served address. - Metadata and Structured Data Review: Checks per-page title and meta description uniqueness, JSON-LD type selection, absolute addresses, and the mirroring rule that every serialized claim has a visible counterpart. - Crawl Artifact and Semantics Audits: Covers host-derived robots.txt and sitemap.xml, heading structure, image alt text, anchor text, and fragment target resolution. - Use Case: Before deploying a site, run a pre-ship review that fetches each route's canonical declaration, collects titles across all routes to find duplicates, and validates that sitemap entries resolve on the deployed host. ## Quick Start Review this page's canonical tag, title, meta description, and JSON-LD for indexing defects before release.

Frequently Asked Questions about moai-ref-seo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my canonical URLs are set correctly?▼

Fetch each route's canonical declaration and confirm it returns that same page with no redirect in between. The declared value must equal the address actually served, and trailing-slash or parameter variants should redirect permanently to one chosen form.

What JSON-LD structured data rules matter for SEO?▼

Derive types from the page's actual role, emit each type's mandatory core fields completely, and use absolute resolving addresses. Every claim in the serialized data needs a visible counterpart on the same page, since unverifiable assertions are scored as negative signals.

Should robots.txt and sitemap.xml be hardcoded per environment?▼

No. Derive the absolute addresses in robots.txt from the incoming request's host so every environment describes itself correctly, and generate the sitemap from the routes actually served. A hardcoded host is correct in exactly one environment and wrong everywhere else.

Does this skill cover accessibility and generative-engine optimization?▼

No. Keyboard operability, focus indicators, and form labeling are delegated to the accessibility surface, and generative-engine optimization is deliberately excluded as insufficiently settled. This reference stays at the protocol and output layer: addresses, headers, markup, and serialized data.

Why is duplicate title or meta description a problem across routes?▼

Uniqueness is the entire purpose of per-page metadata, so a scaffold default reused on every route defeats it. Collect titles and descriptions across all routes before shipping and fail the check if duplicates or placeholder strings survive.