scan-seo

Detect missing SEO metadata in TanStack Start routes and components.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/sncollective/snc-platform --skill scan-seo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scan-seo
Source: https://github.com/sncollective/snc-platform/tree/main/.claude/skills/scan-seo
Command: npx skills add https://github.com/sncollective/snc-platform --skill scan-seo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Many frontend routes and components omit critical SEO metadata or include relative URLs, causing poor search indexing and weak social share previews. This Skill provides deterministic, rule-based checks that surface missing head() metadata, Open Graph tags, canonical links, structured data, resource hints, and image decoding attributes so engineers can prioritize fixes.

Core Features & Use Cases

  • Per-route meta enforcement: Finds routes with loaders that lack dynamic head() title and description.
  • Open Graph & canonical validation: Detects missing og:* tags and absent rel="canonical" links, and notes the SITE_URL prerequisite for absolute URLs.
  • Structured data and image hints: Flags missing JSON-LD, missing decoding="async" on img tags, and absent preconnect/dns-prefetch hints for third-party origins.
  • Reference-driven fixes: Each finding maps to a reference file with rationale, before/after examples, exceptions, and required prerequisites for remediation.
  • Use Case: Run as part of a refactor or CI check to list actionable SEO fixes across apps/web/src/routes and shared UI components.

Quick Start

Run a static scan for missing route meta and Open Graph tags and review the generated findings against the provided reference docs.

Frequently Asked Questions about scan-seo

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

FAQPage Schema
How do I find missing SEO metadata in TanStack Start route files?

To find missing SEO metadata in TanStack Start route files, run a static analysis scan that maps loaders to head() patterns and surfaces missing dynamic titles, descriptions, and Open Graph tags. This generates actionable, reference-backed findings for remediation.

What is static analysis for SEO gaps in frontend components?

Static analysis for SEO gaps is a deterministic, rule-based check that scans frontend components and route files without executing code. It detects missing head() metadata, canonical links, JSON-LD structured data, and image decoding attributes to improve search indexing.

How do I check for missing Open Graph tags and canonical URLs in my web app?

You can check for missing Open Graph tags and canonical URLs by statically analyzing route files for absent og:* tags and rel="canonical" links. The scan verifies the SITE_URL prerequisite required for constructing absolute URLs in these metadata elements.

Does this SEO linter work with apps/web/src/routes directory structures?

Yes, this static analysis tool specifically targets the apps/web/src/routes directory structure. It scans TanStack Start frontend routes and shared UI components within this path to map loader patterns to head() functions and identify absent resource hints.

Why are relative URLs causing poor search indexing in my TanStack Start application?

Relative URLs cause poor search indexing and weak social share previews because crawlers lack the absolute context needed to resolve page identity. Statically scanning for SITE_URL absolute URL usage in canonical links and Open Graph tags enforces correct metadata resolution.

Can I use static analysis to detect missing JSON-LD structured data and resource hints?

Yes, you can use static analysis to detect missing JSON-LD structured data and resource hints. The scan flags absent preconnect and dns-prefetch hints for third-party origins, missing decoding="async" on img tags, and absent JSON-LD across shared UI components.