Agent skill

Nuxt SEO

by secondsky in secondsky/claude-skills

Nuxt SEO v5 modules (robots, sitemap, og-image, schema-org, link-checker, seo-utils, site-config).

MITAuto-check passedMarketing & SEO

Install Nuxt SEO

skills CLI
$ npx skills add secondsky/claude-skills --skill nuxt-seo -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install secondsky/claude-skills nuxt-seo --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ 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-src

Use ~/.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/

Facts

Skill name
nuxt-seo
GitHub stars
227
Token cost
~2.7k tokens
SKILL.md length
806 words
Files
21 (incl. scripts, references, assets)
Skills in repo
169
Repo updated
First seen
Licence
MIT

At a glance

Nuxt SEO v5 modules (robots, sitemap, og-image, schema-org, link-checker, seo-utils, site-config).

  • Works in 3 steps: Install Complete SEO Bundle → Configure Site Settings → Restart and Verify
  • Implementing SEO
  • SKILL.md covers Quick Start (5 Minutes), Module Overview, Critical Rules and Known Issues Prevention, plus 3 more sections
  • Calls npx

What it does

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.

When your agent uses it

  • Implementing SEO
  • Meta tags in Nuxt apps

Example prompts

  • “/nuxt-seo”

Requirements

  • Node.js

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Install Complete SEO Bundle
  2. Configure Site Settings
  3. Restart and Verify

What it can do on your machine

Read from SKILL.md and the folder at commit 8837836. It shows what the files ask for, not the result of running them.

  • Tool permissions

    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.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • nuxtseo.com
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

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.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~54k

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.

Safety

Auto-check passed

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.

SKILL.md

The full file from secondsky/claude-skills at commit 8837836, republished under its MIT licence (© secondsky). 806 words, ~2,718 tokens.

Download SKILL.mdSave it as .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.
name
nuxt-seo
description
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.
license
MIT
metadata.version
4.0.0
metadata.last_updated
2026-08-03
metadata.nuxt_compatibility
>=4.0.0
metadata.auto_trigger_scenarios
Setting up SEO in Nuxt project, Configuring robots.txt or sitemap, Generating Open Graph images, Adding Schema.org structured data, Managing meta tags and…

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.


Quick Start (5 Minutes)

1. Install Complete SEO Bundle
bash
# Recommended (v5)
npx nuxt module add @nuxtjs/seo
2. Configure Site Settings
typescript
export 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 explicitly
  • Set site.url to production URL (required for sitemaps and canonical URLs)
  • Set defaultLocale if using i18n
3. Restart and Verify

Visit these URLs to verify:

  • /robots.txt - Robots file
  • /sitemap.xml - Sitemap
  • /__robots__/debug-production.json - Debug (v5)
  • /__sitemap__/debug-production.json - Debug (v5)
Individual Module Install
bash
npx nuxt module add @nuxtjs/robots
npx nuxt module add @nuxtjs/sitemap
npx nuxt module add nuxt-og-image

Module Overview

ModuleVersionPurpose
@nuxtjs/seov5.1.0Primary SEO module (installs all 8 as bundle)
@nuxtjs/robotsv6.0.6Manages robots.txt and bot detection
@nuxtjs/sitemapv8.0.11Generates XML sitemaps with advanced features
nuxt-og-imagev6.3.1Creates Open Graph images via Vue templates
nuxt-schema-orgv6.0.4Builds Schema.org structured data graphs
nuxt-link-checkerv5.0.6Finds and fixes broken links with ESLint integration
nuxt-seo-utilsv8.1.4SEO utilities, share links, favicons, inline minification
nuxt-site-configv4.0.7Centralized 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

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

Issue #7: Canonical URL Issues

Error: Wrong canonical URL | Fix: Configure site.url and trailingSlash correctly

Issue #8: Sitemap Index Errors

Error: Sitemap index XML malformed | Fix: Use chunkSize option to split large sitemaps

Issue #9: Crawling Staging Environment

Error: Staging indexed by Google | Fix: disallow: process.env.NUXT_PUBLIC_ENV === 'staging' ? ['/'] : []

Issue #10: Missing Social Sharing Images

Error: No preview on social media | Fix: Use defineOgImage() on all important pages

Issue #11: Missing Site Name (v5 Breaking)

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

Show full SKILL.md (325 more words)Show less
Issue #12: Server-Side useSiteConfig Error (v5 Breaking)

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

Issue #13: Deprecated Content Composables (v5 Breaking)

Error: asSitemapCollection is not defined | Fix: Use defineSitemapSchema(), defineSchemaOrgSchema(), defineRobotsSchema() Ref: https://nuxtseo.com/docs/nuxt-seo/migration-guide/v4-to-v5

Issue #14: OG Image Security Errors (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


Configuration Example

typescript
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'] }
    }
  }
})
New v5 Features
  • Social Share Links: useShareLinks({ title, twitter, utm }) with UTM tracking
  • Favicon Generation: npx nuxt-seo-utils icons --source logo.svg
  • ESLint Link Checking: import linkChecker from 'nuxt-link-checker/eslint'
  • definePageMeta Sitemap: definePageMeta({ sitemap: { changefreq: 'daily', priority: 0.8 } })
  • Inline Minification: seo: { minify: true }

When to Load References

Load reference files based on the user's specific needs:

Load WhenReference File
Upgrading v4→v5, breaking changesreferences/v5-migration-guide.md
Rendering modes, JSON-LD, canonical URLs, IndexNowreferences/seo-guides.md
AI optimization, llms.txt, MCP toolsreferences/pro-modules.md
I18n SEO, route rules, link checker rulesreferences/advanced-seo-guides.md
OG image templates, Satori/Chromium, fontsreferences/og-image-guide.md
Nuxt Content integration, asSeoCollectionreferences/nuxt-content-integration.md
Dynamic sitemaps, multi-sitemaps, chunkingreferences/sitemap-advanced.md
Server-side hooks, Nitro pluginsreferences/nitro-api-reference.md
llms.txt, AI crawlers, content signalsreferences/ai-seo-tools.md
Module capabilities overviewreferences/modules-overview.md
First-time setup, package manager specificsreferences/installation-guide.md
Composable API docs, parameter listsreferences/api-reference.md
Blog, e-commerce, multi-language patternsreferences/common-patterns.md
Specific module configurationreferences/module-details.md
Production SEO guidelinesreferences/best-practices.md
Error resolution, module conflictsreferences/troubleshooting.md
Multi-environment, advanced featuresreferences/advanced-configuration.md

Bundled Resources

Agents
AgentPurpose
seo-auditor.mdComprehensive SEO audit
schema-generator.mdGenerate Schema.org structured data
og-image-generator.mdCreate custom OG image templates
link-checker.mdAnalyze internal/external links
sitemap-builder.mdDesign optimal sitemap strategies
Commands
CommandPurpose
/seo-auditRun comprehensive SEO audit
/seo-setupQuick Nuxt SEO project setup
/og-previewPreview OG image generation
/check-linksRun link checker analysis
/validate-sitemapValidate sitemap configuration
/check-schemaValidate Schema.org implementation
Assets
  • assets/package-versions.json — Current module versions for verification

Package Versions (Verified 2026-08-03)

json
{
  "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"
  }
}

Official Documentation

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

Files

SKILL.md and 20 other files (scripts, references, assets) in plugins/nuxt-seo/skills/nuxt-seo of secondsky/claude-skills.

  • SKILL.md
  • assets/package-versions.json
  • references/advanced-configuration.md
  • references/advanced-seo-guides.md
  • references/ai-seo-tools.md
  • references/api-reference.md
  • references/best-practices.md
  • references/common-patterns.md
  • references/installation-guide.md
  • references/module-details.md
  • references/modules-overview.md
  • references/nitro-api-reference.md
  • references/nuxt-content-integration.md
  • references/og-image-guide.md
  • references/pro-modules.md
  • references/seo-guides.md
  • references/sitemap-advanced.md
  • references/troubleshooting.md
  • references/v5-migration-guide.md
  • … and 2 more

Open the folder on GitHubat commit 8837836

Compare with similar skills

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.

Nuxt SEO compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nuxt SEO this skillsecondsky/claude-skills227—~2.7kAutomated safety check: PassMIT
Nuxt SEO Best Practicesvinayakkulkarni/nxui212—~819Automated safety check: PassMIT
SEOgridaco/grida2.7k—~2.1kAutomated safety check: PassApache-2.0
SEO Optimizerailabs-393/ai-labs-claude-skills4541 repos~3.2kAutomated safety check: PassMIT
SEO Setupalisamadiii/Portfolio180—~1.7kAutomated safety check: PassNone
SEOever-works/ever-works15810 repos~2.9kAutomated safety check: PassMIT

Similar skills

  • Nuxt SEO Best Practices

    vinayakkulkarni/nxui

    Nuxt SEO optimization guidelines for Cloudflare-deployed applications.

    212 GitHub stars~819 tokensUpdated today
    Marketing & SEOAuto-check passed
  • SEO

    gridaco/grida

    SEO best practices for the Grida project across Next.js pages, blog posts, and documentation.

    2.7k GitHub stars~2.1k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • SEO Optimizer

    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.

    454 GitHub starsUsed in 1 repo~3.2k tokens
    Marketing & SEOAuto-check passed
  • SEO Setup

    alisamadiii/Portfolio

    Full SEO/metadata setup and audit for client websites (Astro, Next.js, any static site).

    180 GitHub stars~1.7k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • SEO

    ever-works/ever-works

    Optimize for search engine visibility and ranking. An agent skill from ever-works/ever-works.

    158 GitHub starsUsed in 10 repos~2.9k tokens
    Marketing & SEOAuto-check passed
  • Universal SEO Analysis

    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.

    18k GitHub stars~4.9k tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed

More from secondsky/claude-skills

All 169 skills in this repo
  • Tanstack AI

    secondsky/claude-skills

    TanStack AI (alpha) provider-agnostic type-safe chat with streaming for OpenAI, Anthropic, Gemini, Ollama.

    227 GitHub starsUsed in 1 repo~3.6k tokens
    Auto-check: notes
  • Auto Animate

    secondsky/claude-skills

    AutoAnimate (@formkit/auto-animate) zero-config animations for React.

    227 GitHub stars~2.9k tokensUpdated 10 days ago
    Auto-check passed
  • Base UI React

    secondsky/claude-skills

    MUI Base UI unstyled React components with Floating UI. An agent skill from secondsky/claude-skills.

    227 GitHub stars~1.9k tokensUpdated 10 days ago
    Auto-check passed
  • Cloudflare Images

    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"…

    227 GitHub stars~3.6k tokensUpdated 10 days ago
    Auto-check: notes
  • Cloudflare Nextjs

    secondsky/claude-skills

    Deploy Next.js to Cloudflare Workers via the OpenNext adapter (@opennextjs/cloudflare).

    227 GitHub stars~5.3k tokensUpdated 10 days ago
    Auto-check: notes
  • Cloudflare Sandbox

    secondsky/claude-skills

    Cloudflare Sandboxes SDK for secure code execution in Linux containers at edge.

    227 GitHub stars~4.5k tokensUpdated 10 days ago
    Auto-check passed

Works with

Categories

Questions about Nuxt SEO

What does Nuxt SEO do?

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).

When should I use Nuxt SEO?

Nuxt SEO fits situations like: implementing SEO; meta tags in Nuxt apps.

How do I install Nuxt SEO in Claude Code?

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.

How do I install Nuxt SEO in Codex?

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.

Can I use Nuxt SEO in Cursor, Gemini CLI or GitHub Copilot?

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.

What does Nuxt SEO need to run?

Going by SKILL.md and its folder, Nuxt SEO needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Nuxt SEO access the network?

SKILL.md names 2 domains. As links in the text: nuxtseo.com and github.com. This is read from the text; nothing was executed.

Is Nuxt SEO safe to install?

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.

What licence does Nuxt SEO use?

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.

How many tokens does Nuxt SEO use?

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.

What are the alternatives to Nuxt SEO?

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.

Who maintains Nuxt SEO?

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.