Nuxt SEO v5 modules (robots, sitemap, og-image, schema-org, link-checker, seo-utils, site-config). Use when implementing SEO, robots.txt, sitemaps, Schema.org, or meta tags in Nuxt apps.
SKILL.md
Nuxt SEO v5
Status: Production Ready | Dependencies: Nuxt >=4.0.0
Use this skill when building SEO-optimized Nuxt applications with any combination of the 8 official Nuxt SEO modules plus standalone modules.
Finds and fixes broken links with ESLint integration
nuxt-seo-utils
v8.1.4
SEO utilities, share links, favicons, inline minification
nuxt-site-config
v4.0.7
Centralized site configuration management
Standalone (MIT): nuxt-ai-ready (llms.txt), nuxt-skew-protection (version safety)
Pro (Paid): Nuxt SEO Pro — Search Console, Core Web Vitals, MCP server
For detailed module docs: Load references/module-details.md
Critical Rules
Always Do
Set site.url AND site.name explicitly in nuxt.config.ts (v5: name no longer auto-inferred)
Use environment variables for multi-environment setups
Configure robots.txt to block admin/private pages
Add Schema.org structured data to all important pages
Generate OG images for social sharing
Use getSiteConfig(event) on server side (v5: useSiteConfig(event) removed)
Use defineSitemapSchema() for Content v3 (v5: asSitemapCollection() deprecated)
Never Do
Forget to set site.url and site.name (breaks sitemaps, canonical URLs, titles)
Allow crawling of staging environments
Use useSiteConfig(event) on server side (v5: use getSiteConfig(event))
Use asSitemapCollection() (v5: use defineSitemapSchema())
Use getSiteIndexable() (v5: use { indexable } = getSiteConfig(event))
Known Issues Prevention
Issue #1: Sitemap Not Generating
Error: /sitemap.xml returns 404 | Fix: Set site.url in nuxt.config.ts
Issue #2: robots.txt Missing
Error: /robots.txt not accessible | Fix: Install @nuxtjs/robots and set site.url
Issue #3: OG Images Not Rendering
Error: /__og-image__/og.png returns error | Fix: Use Satori-compatible CSS or switch to Chromium renderer
Issue #4: Schema Validation Errors
Error: Invalid JSON-LD | Fix: Follow official Schema.org types, validate with Google Rich Results Test
Issue #5: Broken Internal Links
Error: 404 on internal links | Fix: Enable nuxt-link-checker with ESLint rules during development
Issue #6: Duplicate Meta Tags
Error: Multiple meta tags with same property | Fix: Let modules handle meta tags automatically
