$npx -y skills add vinayakkulkarni/vue-nuxt-best-practices --skill nuxt-geo-best-practicesNuxt GEO (Generative Engine Optimization) guidelines for getting cited by ChatGPT, Perplexity, Claude, Google AI Overviews, and Gemini. Covers AI crawler access (llms.txt, GPTBot/ClaudeBot/PerplexityBot allowlisting), content extractability for RAG retrieval, entity clarity via J
| 1 | # Nuxt GEO Best Practices |
| 2 | |
| 3 | Comprehensive Generative Engine Optimization guide for Nuxt 4 applications. Designed to maximize your brand's citation rate inside AI-generated answers from ChatGPT, Google AI Overviews / AI Mode, Perplexity, Claude, and Gemini. Contains 14 rules across 4 categories, prioritized by evidence-backed impact. |
| 4 | |
| 5 | ## When to Apply |
| 6 | |
| 7 | Reference these guidelines when: |
| 8 | |
| 9 | - Setting up `llms.txt` and `llms-full.txt` for AI agent discovery |
| 10 | - Allowlisting (or blocking) AI crawlers in `robots.txt` (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc.) |
| 11 | - Structuring page content for retrieval-augmented generation (RAG) extractability |
| 12 | - Adding entity clarity via Organization, Person, FAQPage, or HowTo JSON-LD schemas |
| 13 | - Applying the GEO arxiv paper's evidence-backed levers: **statistics, citations, quotations** (+30-40% visibility lift) |
| 14 | - Building a `usePageGeo` composable for per-page AI-friendly meta |
| 15 | - Ensuring AI crawlers see SSR-rendered HTML (not a JavaScript shell) |
| 16 | - Generating an AI-friendly XML sitemap and `sitemap_index.xml` |
| 17 | |
| 18 | ## Recommended Nuxt Modules |
| 19 | |
| 20 | This skill is built for **Nuxt 4** apps. Several rules below show both a "from-scratch" Nitro-route implementation and the equivalent module-based shortcut. Strongly consider installing these — they remove a lot of boilerplate and stay in sync with Nuxt's official patterns: |
| 21 | |
| 22 | - **[`@nuxtjs/seo`](https://github.com/harlan-zw/nuxt-seo)** by Harlan Wilton — meta-module that bundles `@nuxtjs/sitemap`, `@nuxtjs/robots`, `nuxt-schema-org`, `nuxt-og-image`, `nuxt-link-checker`, and `nuxt-seo-utils`. Covers most GEO infrastructure (robots.txt, sitemap, JSON-LD, meta) with one install. |
| 23 | - **[`@nuxtjs/sitemap`](https://nuxtseo.com/docs/sitemap)** — auto-generated sitemap with per-page `lastmod`, hreflang, and exclusions. |
| 24 | - **[`@nuxtjs/robots`](https://nuxtseo.com/docs/robots)** — programmatic `robots.txt` with per-route control and AI bot allow/disallow rules. |
| 25 | - **[`nuxt-schema-org`](https://nuxtseo.com/docs/schema-org)** — type-safe JSON-LD via `defineOrganization`, `defineWebSite`, `defineFaqPage`, `defineHowTo`, `definePerson`, `defineArticle`. |
| 26 | - **[`nuxt-og-image`](https://nuxtseo.com/docs/og-image)** — for OG/share images (covered in the sibling `nuxt-seo-best-practices` skill — note CF Workers caveat there). |
| 27 | |
| 28 | ### Official Nuxt SEO Meta docs |
| 29 | |
| 30 | Nuxt 4 ships first-class SEO/meta primitives. Read these before reinventing anything: |
| 31 | |
| 32 | - **[Nuxt 4 SEO & Meta](https://nuxt.com/docs/4.x/getting-started/seo-meta)** — `useSeoMeta`, `useHead`, `useServerSeoMeta`, `definePageMeta`, the `<Head>` / `<Title>` / `<Meta>` components, and route-level `head` config. |
| 33 | - **[`useSeoMeta`](https://nuxt.com/docs/4.x/api/composables/use-seo-meta)** — typed wrapper around `useHead({ meta: [...] })` with full IntelliSense for OG/Twitter tags. |
| 34 | - **[`useHead`](https://nuxt.com/docs/4.x/api/composables/use-head)** — generic head manager (used here for JSON-LD `script` injection). |
| 35 | |
| 36 | The `usePageGeo` composable in `page-use-page-geo.md` is a thin wrapper over these primitives; it is **not** a replacement for them. |
| 37 | |
| 38 | > **Nuxt 4.5 note:** head management now runs on `unhead` v3 — stricter `useHead` typing and no promise input. The `useHead` JSON-LD injection patterns in this skill use plain synchronous values and are v3-compatible. Also, 4.5's experimental SSR streaming is bot-aware: crawlers automatically receive fully-buffered HTML, so enabling it does not hurt GEO (see `ai-ssr-for-crawlers`). |
| 39 | |
| 40 | ## Evidence Base |
| 41 | |
| 42 | These rules synthesize: |
| 43 | |
| 44 | 1. **GEO: Generative Engine Optimization** (Aggarwal et al., KDD 2024, arXiv:2311.09735) — the foundational paper that benchmarked 9 optimization methods across 10K queries. Key findings adopted here: |
| 45 | - Statistics, Citations, and Quotations boost visibility **by up to 40%** |
| 46 | - Authoritative tone and Fluency optimization show moderate gains |
| 47 | - **Keyword stuffing (classic SEO) FAILS on generative engines** — do not bring SEO keyword density habits into GEO |
| 48 | 2. **Industry GEO playbooks** (Search Engine Land, Semrush AI Visibility Index, Backlinko) — entity clarity, multi-platform presence, sentiment, and measurement frameworks observed across 2,500+ tracked prompts on Google AI Mode and ChatGPT. |
| 49 | |
| 50 | ## Rule Categories by Priority |
| 51 | |
| 52 | | Priority | Category |