Nuxt SEO Best Practices
vinayakkulkarni/nxui
Nuxt SEO optimization guidelines for Cloudflare-deployed applications.
Nuxt SEO v5 modules (robots, sitemap, og-image, schema-org, link-checker, seo-utils, site-config).
$ npx skills add secondsky/claude-skills --skill nuxt-seo -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install secondsky/claude-skills nuxt-seo --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/nuxt-seo/skills/nuxt-seo .claude/skills/nuxt-seo && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "nuxt-seo" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/nuxt-seo/skills/nuxt-seo into .claude/skills/nuxt-seo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nuxt-seo", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/secondsky/claude-skills/tree/main/plugins/nuxt-seo/skills/nuxt-seoType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add secondsky/claude-skills --skill nuxt-seo -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install secondsky/claude-skills nuxt-seo --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/nuxt-seo/skills/nuxt-seo .agents/skills/nuxt-seo && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "nuxt-seo" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/nuxt-seo/skills/nuxt-seo into .agents/skills/nuxt-seo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nuxt-seo", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add secondsky/claude-skills --skill nuxt-seo -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install secondsky/claude-skills nuxt-seo --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/nuxt-seo/skills/nuxt-seo .cursor/skills/nuxt-seo && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "nuxt-seo" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/nuxt-seo/skills/nuxt-seo into .cursor/skills/nuxt-seo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nuxt-seo", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/secondsky/claude-skills.git --path plugins/nuxt-seo/skills/nuxt-seo--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add secondsky/claude-skills --skill nuxt-seo -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install secondsky/claude-skills nuxt-seo --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/nuxt-seo/skills/nuxt-seo .gemini/skills/nuxt-seo && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "nuxt-seo" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/nuxt-seo/skills/nuxt-seo into .gemini/skills/nuxt-seo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nuxt-seo", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install secondsky/claude-skills nuxt-seoInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add secondsky/claude-skills --skill nuxt-seo -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/nuxt-seo/skills/nuxt-seo .github/skills/nuxt-seo && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "nuxt-seo" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/nuxt-seo/skills/nuxt-seo into .github/skills/nuxt-seo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nuxt-seo", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add secondsky/claude-skills --skill nuxt-seo -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install secondsky/claude-skills nuxt-seo --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/nuxt-seo/skills/nuxt-seo .opencode/skills/nuxt-seo && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "nuxt-seo" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/nuxt-seo/skills/nuxt-seo into .opencode/skills/nuxt-seo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nuxt-seo", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
nuxt-seoNuxt SEO v5 modules (robots, sitemap, og-image, schema-org, link-checker, seo-utils, site-config).
Nuxt SEO is an agent skill from secondsky/claude-skills. 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.
Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 22 other files, including scripts, reference files and assets (for example `assets/package-versions.json`, `references/advanced-configuration.md` and `references/advanced-seo-guides.md`).
It sits in Marketing & SEO, covering Technical SEO, Social media graphics and Schema markup. It works with Nuxt. The repository describes itself as: Production-ready skills for Claude Code CLI - Cloudflare, React, Tailwind v4, and AI integrations. The licence is MIT.
3 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 8837836. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Ships 1 file in scripts/, which the agent can run.
Shell commands in SKILL.md call:
npxFrom the folder's file list and the shell code blocks in SKILL.md.
Links to these hosts (documentation or services it may open):
nuxtseo.comgithub.comFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Nuxt SEO loads about 2.7k tokens when it runs, and up to ~54k if it reads all its reference files. Until then it costs about 49 tokens; SKILL.md has 806 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
The full file from secondsky/claude-skills at commit 8837836, republished under its MIT licence (© secondsky). 806 words, ~2,718 tokens.
.claude/skills/nuxt-seo/SKILL.md (or your agent's skills folder). This skill also uses 20 other files; get the full folder from GitHub.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.
# Recommended (v5)
npx nuxt module add @nuxtjs/seoexport default defineNuxtConfig({
modules: ['@nuxtjs/seo'],
site: {
url: 'https://example.com',
name: 'My Awesome Site',
description: 'Building amazing web experiences',
defaultLocale: 'en'
}
})CRITICAL (v5 Breaking Change):
site.name is NO LONGER auto-inferred from package.json — set it explicitlysite.url to production URL (required for sitemaps and canonical URLs)defaultLocale if using i18nVisit these URLs to verify:
/robots.txt - Robots file/sitemap.xml - Sitemap/__robots__/debug-production.json - Debug (v5)/__sitemap__/debug-production.json - Debug (v5)npx nuxt module add @nuxtjs/robots
npx nuxt module add @nuxtjs/sitemap
npx nuxt module add nuxt-og-image| Module | Version | Purpose |
|---|---|---|
| @nuxtjs/seo | v5.1.0 | Primary SEO module (installs all 8 as bundle) |
| @nuxtjs/robots | v6.0.6 | Manages robots.txt and bot detection |
| @nuxtjs/sitemap | v8.0.11 | Generates XML sitemaps with advanced features |
| nuxt-og-image | v6.3.1 | Creates Open Graph images via Vue templates |
| nuxt-schema-org | v6.0.4 | Builds Schema.org structured data graphs |
| nuxt-link-checker | v5.0.6 | 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
site.url AND site.name explicitly in nuxt.config.ts (v5: name no longer auto-inferred)getSiteConfig(event) on server side (v5: useSiteConfig(event) removed)defineSitemapSchema() for Content v3 (v5: asSitemapCollection() deprecated)site.url and site.name (breaks sitemaps, canonical URLs, titles)useSiteConfig(event) on server side (v5: use getSiteConfig(event))asSitemapCollection() (v5: use defineSitemapSchema())getSiteIndexable() (v5: use { indexable } = getSiteConfig(event))Error: /sitemap.xml returns 404 | Fix: Set site.url in nuxt.config.ts
Error: /robots.txt not accessible | Fix: Install @nuxtjs/robots and set site.url
Error: /__og-image__/og.png returns error | Fix: Use Satori-compatible CSS or switch to Chromium renderer
Error: Invalid JSON-LD | Fix: Follow official Schema.org types, validate with Google Rich Results Test
Error: 404 on internal links | Fix: Enable nuxt-link-checker with ESLint rules during development
Error: Multiple meta tags with same property | Fix: Let modules handle meta tags automatically
Error: Wrong canonical URL | Fix: Configure site.url and trailingSlash correctly
Error: Sitemap index XML malformed | Fix: Use chunkSize option to split large sitemaps
Error: Staging indexed by Google | Fix: disallow: process.env.NUXT_PUBLIC_ENV === 'staging' ? ['/'] : []
Error: No preview on social media | Fix: Use defineOgImage() on all important pages
Error: Site title/og:site_name missing | Fix: Set site.name in nuxt.config.ts or NUXT_SITE_NAME env var
Ref: https://nuxtseo.com/docs/nuxt-seo/migration-guide/v4-to-v5
Error: useSiteConfig is not a function on server | Fix: Use getSiteConfig(event) on server side
Ref: https://github.com/harlan-zw/nuxt-site-config/releases
Error: asSitemapCollection is not defined | Fix: Use defineSitemapSchema(), defineSchemaOrgSchema(), defineRobotsSchema()
Ref: https://nuxtseo.com/docs/nuxt-seo/migration-guide/v4-to-v5
Error: OG image requests return 403 or signature errors | Fix: Use defineOgImage() properly; don't manually construct OG image URLs
Ref: https://nuxtseo.com/docs/og-image/getting-started/introduction
export default defineNuxtConfig({
modules: ['@nuxtjs/seo'],
site: {
url: process.env.NUXT_PUBLIC_SITE_URL,
name: 'My Site',
defaultLocale: 'en'
},
robots: {
disallow: process.env.NUXT_PUBLIC_ENV === 'staging' ? ['/'] : []
},
sitemap: {
sitemaps: {
blog: { sources: ['/api/__sitemap__/blog'] }
}
}
})useShareLinks({ title, twitter, utm }) with UTM trackingnpx nuxt-seo-utils icons --source logo.svgimport linkChecker from 'nuxt-link-checker/eslint'definePageMeta({ sitemap: { changefreq: 'daily', priority: 0.8 } })seo: { minify: true }Load reference files based on the user's specific needs:
| Load When | Reference File |
|---|---|
| Upgrading v4→v5, breaking changes | references/v5-migration-guide.md |
| Rendering modes, JSON-LD, canonical URLs, IndexNow | references/seo-guides.md |
| AI optimization, llms.txt, MCP tools | references/pro-modules.md |
| I18n SEO, route rules, link checker rules | references/advanced-seo-guides.md |
| OG image templates, Satori/Chromium, fonts | references/og-image-guide.md |
| Nuxt Content integration, asSeoCollection | references/nuxt-content-integration.md |
| Dynamic sitemaps, multi-sitemaps, chunking | references/sitemap-advanced.md |
| Server-side hooks, Nitro plugins | references/nitro-api-reference.md |
| llms.txt, AI crawlers, content signals | references/ai-seo-tools.md |
| Module capabilities overview | references/modules-overview.md |
| First-time setup, package manager specifics | references/installation-guide.md |
| Composable API docs, parameter lists | references/api-reference.md |
| Blog, e-commerce, multi-language patterns | references/common-patterns.md |
| Specific module configuration | references/module-details.md |
| Production SEO guidelines | references/best-practices.md |
| Error resolution, module conflicts | references/troubleshooting.md |
| Multi-environment, advanced features | references/advanced-configuration.md |
| Agent | Purpose |
|---|---|
seo-auditor.md | Comprehensive SEO audit |
schema-generator.md | Generate Schema.org structured data |
og-image-generator.md | Create custom OG image templates |
link-checker.md | Analyze internal/external links |
sitemap-builder.md | Design optimal sitemap strategies |
| Command | Purpose |
|---|---|
/seo-audit | Run comprehensive SEO audit |
/seo-setup | Quick Nuxt SEO project setup |
/og-preview | Preview OG image generation |
/check-links | Run link checker analysis |
/validate-sitemap | Validate sitemap configuration |
/check-schema | Validate Schema.org implementation |
assets/package-versions.json — Current module versions for verification{
"dependencies": {
"@nuxtjs/seo": "^5.1.0",
"@nuxtjs/robots": "^6.0.6",
"@nuxtjs/sitemap": "^8.0.11",
"nuxt-og-image": "^6.3.1",
"nuxt-schema-org": "^6.0.4",
"nuxt-link-checker": "^5.0.6",
"nuxt-seo-utils": "^8.1.4",
"nuxt-site-config": "^4.0.7"
}
}Production Ready: All patterns based on official documentation from https://nuxtseo.com/llms-full.txt | Last verified: 2026-08-03
© secondsky, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 20 other files (scripts, references, assets) in plugins/nuxt-seo/skills/nuxt-seo of secondsky/claude-skills.
Open the folder on GitHubat commit 8837836
Nuxt SEO next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Nuxt SEO this skillsecondsky/claude-skills | 227 | — | ~2.7k | Automated safety check: Pass | MIT | |
| Nuxt SEO Best Practicesvinayakkulkarni/nxui | 212 | — | ~819 | Automated safety check: Pass | MIT | |
| SEOgridaco/grida | 2.7k | — | ~2.1k | Automated safety check: Pass | Apache-2.0 | |
| SEO Optimizerailabs-393/ai-labs-claude-skills | 454 | 1 repos | ~3.2k | Automated safety check: Pass | MIT | |
| SEO Setupalisamadiii/Portfolio | 180 | — | ~1.7k | Automated safety check: Pass | None | |
| SEOever-works/ever-works | 158 | 10 repos | ~2.9k | Automated safety check: Pass | MIT |
vinayakkulkarni/nxui
Nuxt SEO optimization guidelines for Cloudflare-deployed applications.
gridaco/grida
SEO best practices for the Grida project across Next.js pages, blog posts, and documentation.
ailabs-393/ai-labs-claude-skills
This skill should be used when analyzing HTML/CSS websites for SEO optimization, fixing SEO issues, generating SEO reports, or implementing SEO best practices.
alisamadiii/Portfolio
Full SEO/metadata setup and audit for client websites (Astro, Next.js, any static site).
ever-works/ever-works
Optimize for search engine visibility and ranking. An agent skill from ever-works/ever-works.
AgriciDaniel/claude-seo
Hub for site-wide SEO work: audits, technical checks, schema, content quality, local, hreflang and AI-search readiness, run through slash commands.
secondsky/claude-skills
TanStack AI (alpha) provider-agnostic type-safe chat with streaming for OpenAI, Anthropic, Gemini, Ollama.
secondsky/claude-skills
AutoAnimate (@formkit/auto-animate) zero-config animations for React.
secondsky/claude-skills
MUI Base UI unstyled React components with Floating UI. An agent skill from secondsky/claude-skills.
secondsky/claude-skills
This skill should be used when the user asks to "upload images to Cloudflare", "implement direct creator upload", "configure image transformations", "optimize WebP/AVIF", "create image variants"…
secondsky/claude-skills
Deploy Next.js to Cloudflare Workers via the OpenNext adapter (@opennextjs/cloudflare).
secondsky/claude-skills
Cloudflare Sandboxes SDK for secure code execution in Linux containers at edge.
Works with
Categories
Nuxt SEO v5 modules (robots, sitemap, og-image, schema-org, link-checker, seo-utils, site-config). Nuxt SEO is an agent skill from secondsky/claude-skills. Nuxt SEO v5 modules (robots, sitemap, og-image, schema-org, link-checker, seo-utils, site-config).
Nuxt SEO fits situations like: implementing SEO; meta tags in Nuxt apps.
Run `npx skills add secondsky/claude-skills --skill nuxt-seo -a claude-code`. Or copy the skill folder (plugins/nuxt-seo/skills/nuxt-seo in secondsky/claude-skills) into .claude/skills/nuxt-seo in your project. Claude Code loads it when a task matches its description.
Run `npx skills add secondsky/claude-skills --skill nuxt-seo -a codex`. Or copy the skill folder (plugins/nuxt-seo/skills/nuxt-seo in secondsky/claude-skills) into .agents/skills/nuxt-seo in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add secondsky/claude-skills --skill nuxt-seo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nuxt-seo, .gemini/skills/nuxt-seo, .github/skills/nuxt-seo and .opencode/skills/nuxt-seo in your project.
Going by SKILL.md and its folder, Nuxt SEO needs the command-line tools its instructions call (npx). Our summary lists: Node.js.
SKILL.md names 2 domains. As links in the text: nuxtseo.com and github.com. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Nuxt SEO is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 52k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Nuxt SEO: Nuxt SEO Best Practices (vinayakkulkarni/nxui, 212 stars), SEO (gridaco/grida, 2.7k stars), SEO Optimizer (ailabs-393/ai-labs-claude-skills, 454 stars) and SEO Setup (alisamadiii/Portfolio, 180 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
secondsky (a GitHub user) maintains it in secondsky/claude-skills, which has 227 GitHub stars. The repository holds 169 skills in this directory. The repository was last updated on September 28, 2026.
Source: secondsky/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.