moai-ref-seo

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

Updated Aug 29, 2026
One-click install
npx skills add https://github.com/Seung-zedd/secure-file-upload --skill moai-ref-seo-seung-zedd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: moai-ref-seo
Source: https://github.com/Seung-zedd/secure-file-upload/tree/main/.claude/skills/moai-ref-seo
Command: npx skills add https://github.com/Seung-zedd/secure-file-upload --skill moai-ref-seo-seung-zedd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Pages get indexed based on what a machine can fetch and parse, not what a person sees after rendering. This Skill provides a reference of production-grade rules that prevent the two dominant search-visibility failures: the same content reachable at multiple addresses, and structured-data claims that nothing on the visible page corroborates. ## Core Features & Use Cases - Canonical and Identity Rules: Enforce one address per resource with redirect discipline, trailing-slash normalization, and parameterized-route canonical construction. - Metadata and Structured Data Review: Check per-page title and meta description uniqueness, JSON-LD type selection, absolute addressing, and the mirroring rule that every serialized claim needs a visible counterpart. - Crawl Artifact Guidance: Derive robots.txt and sitemap.xml from the request host and actual routes instead of hardcoded environment-specific values. - Use Case: Before shipping a SvelteKit or any HTML-emitting site, run a pre-ship review that fetches each route, verifies one h1 per page, confirms canonical declarations resolve without redirects, and validates that JSON-LD entities match visible page content. ## Quick Start Review the pages in this project for search visibility issues, checking canonical URLs, per-page titles, JSON-LD consistency, and robots.txt host derivation before deployment.

Frequently Asked Questions about moai-ref-seo

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

FAQPage Schema
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. The scope is limited to protocol and output-layer concerns: addresses, headers, markup, and serialized data.