[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79AEQQ5M4HCNG2EB3JF7H3W":3,"skill-same:01M79AEQQ5M4HCNG2EB3JF7H3W":82},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":46,"commitSha":47,"skillDirectory":48,"forksCount":14,"repositoryHtmlUrl":49,"repositoryHomepageUrl":6,"ownerHtmlUrl":50,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":51,"install":52,"resources":65},"01M79AEQQ5M4HCNG2EB3JF7H3W","nuxt-core",null,"| Nuxt 4 core framework fundamentals: project setup, configuration, routing, SEO, error handling, and directory structure. Use when: creating new Nuxt 4 projects, configuring nuxt.config.ts, setting up routing and middleware, implementing SEO with useHead\u002FuseSeoMeta, handling errors with error.vue and NuxtErrorBoundary, or understanding Nuxt 4 directory structure.","Elogic360\u002Fsoftware-factory","Elogic360","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F156535519?v=4","01M74NH3F0RB13PWB7JZDE2V80","elogic360","01M74NH3FPC65082MDZVMFHDM3",0,"MIT","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fnuxt-v4\u002Fskills\u002Fnuxt-core\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: nuxt-core\ndescription: \"| Nuxt 4 core framework fundamentals: project setup, configuration, routing, SEO, error handling, and directory structure. Use when: creating new Nuxt 4 projects, configuring nuxt.config.ts, setting up routing and middleware, implementing SEO with useHead\u002FuseSeoMeta, handling errors with error.vue and NuxtErrorBoundary, or understanding Nuxt 4 directory structure.\"\nlicense: MIT\nmetadata:\n  version: 4.0.0\n  author: Claude Skills Maintainers\n  category: Framework\n  framework: Nuxt\n  framework-version: 4.x\n  last-verified: 2025-12-28\n  keywords:\n    - Nuxt 4\n    - nuxt.config.ts\n    - file-based routing\n    - pages directory\n    - definePageMeta\n    - useHead\n    - useSeoMeta\n    - error.vue\n    - NuxtErrorBoundary\n    - middleware\n    - navigateTo\n    - NuxtLink\n    - app directory\n    - runtime config\n---\n# Nuxt 4 Core Fundamentals\n\nProject setup, configuration, routing, SEO, and error handling for Nuxt 4 applications.\n\n## Quick Reference\n\n### Version Requirements\n\n| Package | Minimum | Recommended |\n|---------|---------|-------------|\n| nuxt | 4.0.0 | 4.2.x |\n| vue | 3.5.0 | 3.5.x |\n| nitro | 2.10.0 | 2.12.x |\n| vite | 6.0.0 | 6.2.x |\n| typescript | 5.0.0 | 5.x |\n\n### Key Commands\n\n```bash\n# Create new project\nbunx nuxi@latest init my-app\n\n# Development\nbun run dev\n\n# Build for production\nbun run build\n\n# Preview production build\nbun run preview\n\n# Type checking\nbun run postinstall  # Generates .nuxt directory\nbunx nuxi typecheck\n\n# Add a page\u002Fcomponent\u002Fcomposable\nbunx nuxi add page about\nbunx nuxi add component MyButton\nbunx nuxi add composable useAuth\n```\n\n## Secure Installation\n\nScaffolding tools like `bunx nuxi init` download and execute remote code. Before running, follow supply chain security best practices:\n\n- **Block post-install scripts** — `npm config set ignore-scripts true` (or Bun: disabled by default)\n- **Cooldown period** — Wait 7 days for new package versions to be vetted by the community\n- **Audit before installing** — Run `socket package score npm \u003Cpkg>` or use `socket npm install \u003Cpkg>` to check packages\n\nLoad the `dependency-upgrade` skill for full security configuration including Socket CLI integration, cooldown setup, lockfile validation, and CI enforcement.\n\n## Directory Structure (Nuxt v4)\n\n```\nmy-nuxt-app\u002F\n├── app\u002F                    # Default srcDir in v4\n│   ├── assets\u002F             # Build-processed assets (CSS, images)\n│   ├── components\u002F         # Auto-imported Vue components\n│   ├── composables\u002F        # Auto-imported composables\n│   ├── layouts\u002F            # Layout components\n│   ├── middleware\u002F         # Route middleware\n│   ├── pages\u002F              # File-based routing\n│   ├── plugins\u002F            # Nuxt plugins\n│   ├── utils\u002F              # Auto-imported utility functions\n│   ├── app.vue             # Main app component\n│   ├── app.config.ts       # App-level runtime config\n│   ├── error.vue           # Error page component\n│   └── router.options.ts   # Router configuration\n│\n├── server\u002F                 # Server-side code (Nitro)\n│   ├── api\u002F                # API endpoints\n│   ├── middleware\u002F         # Server middleware\n│   ├── plugins\u002F            # Nitro plugins\n│   ├── routes\u002F             # Server routes\n│   └── utils\u002F              # Server utilities\n│\n├── public\u002F                 # Static assets (served from root)\n├── shared\u002F                 # Shared code (app + server)\n├── content\u002F                # Nuxt Content files (if using)\n├── layers\u002F                 # Nuxt layers\n├── modules\u002F                # Local modules\n├── .nuxt\u002F                  # Generated files (git ignored)\n├── .output\u002F                # Build output (git ignored)\n├── nuxt.config.ts          # Nuxt configuration\n├── tsconfig.json           # TypeScript configuration\n└── package.json            # Dependencies\n```\n\n**Key Change in v4**: The `app\u002F` directory is now the default `srcDir`. All app code goes in `app\u002F`, server code stays in `server\u002F`.\n\n## When to Load References\n\n**Load `references\u002Fconfiguration-deep.md` when:**\n- Configuring advanced nuxt.config.ts options\n- Setting up modules and plugins\n- Customizing Vite or Nitro configuration\n- Configuring experimental features\n\n**Load `references\u002Frouting-advanced.md` when:**\n- Implementing complex routing patterns\n- Creating route middleware with authentication\n- Using catch-all routes or optional parameters\n- Configuring router options\n\n**Load `references\u002Fplugins-architecture.md` when:**\n- Creating Nuxt plugins\n- Injecting global utilities or composables\n- Integrating third-party libraries\n- Understanding plugin execution order\n\n## Configuration\n\n### Basic nuxt.config.ts\n\n```typescript\nexport default defineNuxtConfig({\n  \u002F\u002F Enable Nuxt 4 features\n  future: {\n    compatibilityVersion: 4\n  },\n\n  \u002F\u002F Development tools\n  devtools: { enabled: true },\n\n  \u002F\u002F Modules\n  modules: [\n    '@nuxt\u002Fui',\n    '@nuxt\u002Fcontent',\n    '@nuxt\u002Fimage'\n  ],\n\n  \u002F\u002F Runtime config (environment variables)\n  runtimeConfig: {\n    \u002F\u002F Server-only (not exposed to client)\n    apiSecret: process.env.API_SECRET,\n    databaseUrl: process.env.DATABASE_URL,\n\n    \u002F\u002F Public (client + server)\n    public: {\n      apiBase: process.env.API_BASE || 'https:\u002F\u002Fapi.example.com',\n      appName: 'My App'\n    }\n  },\n\n  \u002F\u002F App config\n  app: {\n    head: {\n      title: 'My Nuxt App',\n      meta: [\n        { charset: 'utf-8' },\n        { name: 'viewport', content: 'width=device-width, initial-scale=1' }\n      ]\n    }\n  },\n\n  \u002F\u002F Nitro config (server)\n  nitro: {\n    preset: 'cloudflare-pages'\n  },\n\n  \u002F\u002F TypeScript\n  typescript: {\n    strict: true,\n    typeCheck: true\n  }\n})\n```\n\n### Runtime Config Usage\n\n```typescript\n\u002F\u002F In composables or components\nconst config = useRuntimeConfig()\n\n\u002F\u002F Public values (client + server)\nconst apiBase = config.public.apiBase\n\n\u002F\u002F Server-only values (only in server\u002F)\nconst apiSecret = config.apiSecret  \u002F\u002F undefined on client!\n```\n\n**Critical Rule**: Always use `useRuntimeConfig()` instead of `process.env` for environment variables in production.\n\n### App Config vs Runtime Config\n\n| Feature | App Config | Runtime Config |\n|---------|------------|----------------|\n| Location | `app.config.ts` | `nuxt.config.ts` |\n| Hot reload | Yes | No |\n| Secrets | No | Yes (server-only) |\n| Use case | UI settings, themes | API keys, URLs |\n\n```typescript\n\u002F\u002F app\u002Fapp.config.ts - UI settings (hot-reloadable)\nexport default defineAppConfig({\n  theme: {\n    primaryColor: '#3490dc'\n  },\n  ui: {\n    rounded: 'lg'\n  }\n})\n\n\u002F\u002F Usage\nconst appConfig = useAppConfig()\nconst color = appConfig.theme.primaryColor\n```\n\n## Routing\n\n### File-Based Routing\n\n```\napp\u002Fpages\u002F\n├── index.vue              → \u002F\n├── about.vue              → \u002Fabout\n├── users\u002F\n│   ├── index.vue          → \u002Fusers\n│   └── [id].vue           → \u002Fusers\u002F:id\n└── blog\u002F\n    ├── index.vue          → \u002Fblog\n    ├── [slug].vue         → \u002Fblog\u002F:slug\n    └── [...slug].vue      → \u002Fblog\u002F* (catch-all)\n```\n\n### Dynamic Routes\n\n```vue\n\u003C!-- app\u002Fpages\u002Fusers\u002F[id].vue -->\n\u003Cscript setup lang=\"ts\">\nconst route = useRoute()\n\n\u002F\u002F Get route params\nconst userId = route.params.id\n\n\u002F\u002F Reactive (updates when route changes)\nconst userId = computed(() => route.params.id)\n\n\u002F\u002F Fetch user data\nconst { data: user } = await useFetch(`\u002Fapi\u002Fusers\u002F${userId.value}`)\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cdiv>\n    \u003Ch1>{{ user?.name }}\u003C\u002Fh1>\n  \u003C\u002Fdiv>\n\u003C\u002Ftemplate>\n```\n\n### Navigation\n\n```vue\n\u003Cscript setup>\nconst goToUser = (id: string) => {\n  navigateTo(`\u002Fusers\u002F${id}`)\n}\n\nconst goBack = () => {\n  navigateTo(-1)  \u002F\u002F Go back in history\n}\n\n\u002F\u002F With options\nconst goToLogin = () => {\n  navigateTo('\u002Flogin', {\n    replace: true,  \u002F\u002F Replace current history entry\n    external: false \u002F\u002F Internal navigation\n  })\n}\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003C!-- Declarative navigation -->\n  \u003CNuxtLink to=\"\u002Fabout\">About\u003C\u002FNuxtLink>\n  \u003CNuxtLink :to=\"`\u002Fusers\u002F${user.id}`\">View User\u003C\u002FNuxtLink>\n\n  \u003C!-- Prefetching (default: on hover) -->\n  \u003CNuxtLink to=\"\u002Fdashboard\" prefetch>Dashboard\u003C\u002FNuxtLink>\n\n  \u003C!-- No prefetch -->\n  \u003CNuxtLink to=\"\u002Fadmin\" :prefetch=\"false\">Admin\u003C\u002FNuxtLink>\n\u003C\u002Ftemplate>\n```\n\n### Route Middleware\n\n```typescript\n\u002F\u002F app\u002Fmiddleware\u002Fauth.ts\nexport default defineNuxtRouteMiddleware((to, from) => {\n  const { isAuthenticated } = useAuth()\n\n  if (!isAuthenticated.value) {\n    return navigateTo('\u002Flogin')\n  }\n})\n```\n\n```vue\n\u003C!-- app\u002Fpages\u002Fdashboard.vue -->\n\u003Cscript setup lang=\"ts\">\ndefinePageMeta({\n  middleware: 'auth'\n})\n\u003C\u002Fscript>\n```\n\n### Global Middleware\n\n```typescript\n\u002F\u002F app\u002Fmiddleware\u002Fanalytics.global.ts\nexport default defineNuxtRouteMiddleware((to, from) => {\n  \u002F\u002F Runs on every route change\n  if (import.meta.client) {\n    window.gtag?.('event', 'page_view', {\n      page_path: to.path\n    })\n  }\n})\n```\n\n### Page Meta\n\n```vue\n\u003Cscript setup lang=\"ts\">\ndefinePageMeta({\n  title: 'Dashboard',\n  middleware: ['auth'],\n  layout: 'admin',\n  pageTransition: { name: 'fade' },\n  keepalive: true\n})\n\u003C\u002Fscript>\n```\n\n## SEO & Meta Tags\n\n### useSeoMeta (Recommended)\n\n```vue\n\u003Cscript setup lang=\"ts\">\nuseSeoMeta({\n  title: 'My Page Title',\n  description: 'Page description for search engines',\n  ogTitle: 'My Page Title',\n  ogDescription: 'Page description',\n  ogImage: 'https:\u002F\u002Fexample.com\u002Fog-image.jpg',\n  ogUrl: 'https:\u002F\u002Fexample.com\u002Fmy-page',\n  twitterCard: 'summary_large_image',\n  twitterTitle: 'My Page Title',\n  twitterDescription: 'Page description',\n  twitterImage: 'https:\u002F\u002Fexample.com\u002Fog-image.jpg'\n})\n\u003C\u002Fscript>\n```\n\n### useHead (More Control)\n\n```vue\n\u003Cscript setup lang=\"ts\">\nuseHead({\n  title: 'My Page Title',\n  meta: [\n    { name: 'description', content: 'Page description' },\n    { property: 'og:title', content: 'My Page Title' }\n  ],\n  link: [\n    { rel: 'canonical', href: 'https:\u002F\u002Fexample.com\u002Fmy-page' }\n  ],\n  script: [\n    { src: 'https:\u002F\u002Fexample.com\u002Fscript.js', defer: true }\n  ]\n})\n\u003C\u002Fscript>\n```\n\n### Dynamic Meta Tags\n\n```vue\n\u003Cscript setup lang=\"ts\">\nconst { data: post } = await useFetch(`\u002Fapi\u002Fposts\u002F${route.params.slug}`)\n\nuseSeoMeta({\n  title: () => post.value?.title,\n  description: () => post.value?.excerpt,\n  ogImage: () => post.value?.image\n})\n\u003C\u002Fscript>\n```\n\n### Title Template\n\n```typescript\n\u002F\u002F nuxt.config.ts\nexport default defineNuxtConfig({\n  app: {\n    head: {\n      titleTemplate: '%s | My App'  \u002F\u002F \"Page Title | My App\"\n    }\n  }\n})\n```\n\n## Error Handling\n\n### Error Page\n\n```vue\n\u003C!-- app\u002Ferror.vue -->\n\u003Cscript setup lang=\"ts\">\nimport type { NuxtError } from '#app'\n\nconst props = defineProps\u003C{\n  error: NuxtError\n}>()\n\nconst handleError = () => {\n  clearError({ redirect: '\u002F' })\n}\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cdiv class=\"error-page\">\n    \u003Ch1>{{ error.statusCode }}\u003C\u002Fh1>\n    \u003Cp>{{ error.message }}\u003C\u002Fp>\n    \u003Cbutton @click=\"handleError\">Go Home\u003C\u002Fbutton>\n  \u003C\u002Fdiv>\n\u003C\u002Ftemplate>\n```\n\n### Error Boundaries (Component-Level)\n\n```vue\n\u003Ctemplate>\n  \u003CNuxtErrorBoundary @error=\"handleError\">\n    \u003Ctemplate #error=\"{ error, clearError }\">\n      \u003Cdiv class=\"error-container\">\n        \u003Ch2>Something went wrong\u003C\u002Fh2>\n        \u003Cp>{{ error.message }}\u003C\u002Fp>\n        \u003Cbutton @click=\"clearError\">Try again\u003C\u002Fbutton>\n      \u003C\u002Fdiv>\n    \u003C\u002Ftemplate>\n\n    \u003C!-- Your component content -->\n    \u003CMyComponent \u002F>\n  \u003C\u002FNuxtErrorBoundary>\n\u003C\u002Ftemplate>\n\n\u003Cscript setup>\nconst handleError = (error: Error) => {\n  console.error('Component error:', error)\n  \u002F\u002F Send to error tracking service\n}\n\u003C\u002Fscript>\n```\n\n### Throwing Errors\n\n```typescript\n\u002F\u002F In pages or components\nthrow createError({\n  statusCode: 404,\n  statusMessage: 'Page Not Found',\n  fatal: true  \u002F\u002F Shows error page, stops rendering\n})\n\n\u002F\u002F Non-fatal error (shows inline)\nthrow createError({\n  statusCode: 400,\n  message: 'Invalid input'\n})\n```\n\n### API Error Handling\n\n```typescript\nconst { data, error } = await useFetch('\u002Fapi\u002Fusers')\n\nif (error.value) {\n  \u002F\u002F Handle error gracefully\n  showError({\n    statusCode: error.value.statusCode,\n    message: error.value.message\n  })\n}\n```\n\n## Common Anti-Patterns\n\n### Using process.env Instead of Runtime Config\n\n```typescript\n\u002F\u002F WRONG - Won't work in production!\nconst apiUrl = process.env.API_URL\n\n\u002F\u002F CORRECT\nconst config = useRuntimeConfig()\nconst apiUrl = config.public.apiBase\n```\n\n### Missing Middleware Guards\n\n```typescript\n\u002F\u002F WRONG - No return, middleware continues\nexport default defineNuxtRouteMiddleware((to) => {\n  const { isAuthenticated } = useAuth()\n  if (!isAuthenticated.value) {\n    navigateTo('\u002Flogin')  \u002F\u002F Missing return!\n  }\n})\n\n\u002F\u002F CORRECT\nexport default defineNuxtRouteMiddleware((to) => {\n  const { isAuthenticated } = useAuth()\n  if (!isAuthenticated.value) {\n    return navigateTo('\u002Flogin')  \u002F\u002F Return stops middleware chain\n  }\n})\n```\n\n### Non-Reactive Route Params\n\n```typescript\n\u002F\u002F WRONG - Not reactive\nconst userId = route.params.id\n\n\u002F\u002F CORRECT - Reactive\nconst userId = computed(() => route.params.id)\n```\n\n## Troubleshooting\n\n**Build Errors \u002F Type Errors:**\n```bash\nrm -rf .nuxt .output node_modules\u002F.vite && bun install && bun run dev\n```\n\n**Route Not Found:**\n- Check file is in `app\u002Fpages\u002F` (not root `pages\u002F`)\n- Verify file extension is `.vue`\n- Check for typos in dynamic params `[id].vue`\n\n**Middleware Not Running:**\n- Ensure file has `.global.ts` suffix for global middleware\n- Check `definePageMeta({ middleware: 'name' })` matches filename\n- Verify middleware returns `navigateTo()` or nothing\n\n**Meta Tags Not Updating:**\n- Use reactive values: `title: () => post.value?.title`\n- Ensure `useSeoMeta` is called in `\u003Cscript setup>`\n\n## Related Skills\n\n- **nuxt-data**: Composables, data fetching, state management\n- **nuxt-server**: Server routes, API patterns, database integration\n- **nuxt-production**: Performance, testing, deployment\n- **nuxt-ui-v4**: Nuxt UI component library\n\n## Templates Available\n\nSee `templates\u002F` directory for:\n- Production-ready `nuxt.config.ts`\n- `app.vue` with proper structure\n- Middleware examples\n\n---\n\n**Version**: 4.0.0 | **Last Updated**: 2025-12-28 | **License**: MIT\n","# Nuxt 4 Core Fundamentals\n\nProject setup, configuration, routing, SEO, and error handling for Nuxt 4 applications.\n\n## Quick Reference\n\n### Version Requirements\n\n| Package | Minimum | Recommended |\n|---------|---------|-------------|\n| nuxt | 4.0.0 | 4.2.x |\n| vue | 3.5.0 | 3.5.x |\n| nitro | 2.10.0 | 2.12.x |\n| vite | 6.0.0 | 6.2.x |\n| typescript | 5.0.0 | 5.x |\n\n### Key Commands\n\n```bash\n# Create new project\nbunx nuxi@latest init my-app\n\n# Development\nbun run dev\n\n# Build for production\nbun run build\n\n# Preview production build\nbun run preview\n\n# Type checking\nbun run postinstall  # Generates .nuxt directory\nbunx nuxi typecheck\n\n# Add a page\u002Fcomponent\u002Fcomposable\nbunx nuxi add page about\nbunx nuxi add component MyButton\nbunx nuxi add composable useAuth\n```\n\n## Secure Installation\n\nScaffolding tools like `bunx nuxi init` download and execute remote code. Before running, follow supply chain security best practices:\n\n- **Block post-install scripts** — `npm config set ignore-scripts true` (or Bun: disabled by default)\n- **Cooldown period** — Wait 7 days for new package versions to be vetted by the community\n- **Audit before installing** — Run `socket package score npm \u003Cpkg>` or use `socket npm install \u003Cpkg>` to check packages\n\nLoad the `dependency-upgrade` skill for full security configuration including Socket CLI integration, cooldown setup, lockfile validation, and CI enforcement.\n\n## Directory Structure (Nuxt v4)\n\n```\nmy-nuxt-app\u002F\n├── app\u002F                    # Default srcDir in v4\n│   ├── assets\u002F             # Build-processed assets (CSS, images)\n│   ├── components\u002F         # Auto-imported Vue components\n│   ├── composables\u002F        # Auto-imported composables\n│   ├── layouts\u002F            # Layout components\n│   ├── middleware\u002F         # Route middleware\n│   ├── pages\u002F              # File-based routing\n│   ├── plugins\u002F            # Nuxt plugins\n│   ├── utils\u002F              # Auto-imported utility functions\n│   ├── app.vue             # Main app component\n│   ├── app.config.ts       # App-level runtime config\n│   ├── error.vue           # Error page component\n│   └── router.options.ts   # Router configuration\n│\n├── server\u002F                 # Server-side code (Nitro)\n│   ├── api\u002F                # API endpoints\n│   ├── middleware\u002F         # Server middleware\n│   ├── plugins\u002F            # Nitro plugins\n│   ├── routes\u002F             # Server routes\n│   └── utils\u002F              # Server utilities\n│\n├── public\u002F                 # Static assets (served from root)\n├── shared\u002F                 # Shared code (app + server)\n├── content\u002F                # Nuxt Content files (if using)\n├── layers\u002F                 # Nuxt layers\n├── modules\u002F                # Local modules\n├── .nuxt\u002F                  # Generated files (git ignored)\n├── .output\u002F                # Build output (git ignored)\n├── nuxt.config.ts          # Nuxt configuration\n├── tsconfig.json           # TypeScript configuration\n└── package.json            # Dependencies\n```\n\n**Key Change in v4**: The `app\u002F` directory is now the default `srcDir`. All app code goes in `app\u002F`, server code stays in `server\u002F`.\n\n## When to Load References\n\n**Load `references\u002Fconfiguration-deep.md` when:**\n- Configuring advanced nuxt.config.ts options\n- Setting up modules and plugins\n- Customizing Vite or Nitro configuration\n- Configuring experimental features\n\n**Load `references\u002Frouting-advanced.md` when:**\n- Implementing complex routing patterns\n- Creating route middleware with authentication\n- Using catch-all routes or optional parameters\n- Configuring router options\n\n**Load `references\u002Fplugins-architecture.md` when:**\n- Creating Nuxt plugins\n- Injecting global utilities or composables\n- Integrating third-party libraries\n- Understanding plugin execution order\n\n## Configuration\n\n### Basic nuxt.config.ts\n\n```typescript\nexport default defineNuxtConfig({\n  \u002F\u002F Enable Nuxt 4 features\n  future: {\n    compatibilityVersion: 4\n  },\n\n  \u002F\u002F Development tools\n  devtools: { enabled: true },\n\n  \u002F\u002F Modules\n  modules: [\n    '@nuxt\u002Fui',\n    '@nuxt\u002Fcontent',\n    '@nuxt\u002Fimage'\n  ],\n\n  \u002F\u002F Runtime config (environment variables)\n  runtimeConfig: {\n    \u002F\u002F Server-only (not exposed to client)\n    apiSecret: process.env.API_SECRET,\n    databaseUrl: process.env.DATABASE_URL,\n\n    \u002F\u002F Public (client + server)\n    public: {\n      apiBase: process.env.API_BASE || 'https:\u002F\u002Fapi.example.com',\n      appName: 'My App'\n    }\n  },\n\n  \u002F\u002F App config\n  app: {\n    head: {\n      title: 'My Nuxt App',\n      meta: [\n        { charset: 'utf-8' },\n        { name: 'viewport', content: 'width=device-width, initial-scale=1' }\n      ]\n    }\n  },\n\n  \u002F\u002F Nitro config (server)\n  nitro: {\n    preset: 'cloudflare-pages'\n  },\n\n  \u002F\u002F TypeScript\n  typescript: {\n    strict: true,\n    typeCheck: true\n  }\n})\n```\n\n### Runtime Config Usage\n\n```typescript\n\u002F\u002F In composables or components\nconst config = useRuntimeConfig()\n\n\u002F\u002F Public values (client + server)\nconst apiBase = config.public.apiBase\n\n\u002F\u002F Server-only values (only in server\u002F)\nconst apiSecret = config.apiSecret  \u002F\u002F undefined on client!\n```\n\n**Critical Rule**: Always use `useRuntimeConfig()` instead of `process.env` for environment variables in production.\n\n### App Config vs Runtime Config\n\n| Feature | App Config | Runtime Config |\n|---------|------------|----------------|\n| Location | `app.config.ts` | `nuxt.config.ts` |\n| Hot reload | Yes | No |\n| Secrets | No | Yes (server-only) |\n| Use case | UI settings, themes | API keys, URLs |\n\n```typescript\n\u002F\u002F app\u002Fapp.config.ts - UI settings (hot-reloadable)\nexport default defineAppConfig({\n  theme: {\n    primaryColor: '#3490dc'\n  },\n  ui: {\n    rounded: 'lg'\n  }\n})\n\n\u002F\u002F Usage\nconst appConfig = useAppConfig()\nconst color = appConfig.theme.primaryColor\n```\n\n## Routing\n\n### File-Based Routing\n\n```\napp\u002Fpages\u002F\n├── index.vue              → \u002F\n├── about.vue              → \u002Fabout\n├── users\u002F\n│   ├── index.vue          → \u002Fusers\n│   └── [id].vue           → \u002Fusers\u002F:id\n└── blog\u002F\n    ├── index.vue          → \u002Fblog\n    ├── [slug].vue         → \u002Fblog\u002F:slug\n    └── [...slug].vue      → \u002Fblog\u002F* (catch-all)\n```\n\n### Dynamic Routes\n\n```vue\n\u003C!-- app\u002Fpages\u002Fusers\u002F[id].vue -->\n\u003Cscript setup lang=\"ts\">\nconst route = useRoute()\n\n\u002F\u002F Get route params\nconst userId = route.params.id\n\n\u002F\u002F Reactive (updates when route changes)\nconst userId = computed(() => route.params.id)\n\n\u002F\u002F Fetch user data\nconst { data: user } = await useFetch(`\u002Fapi\u002Fusers\u002F${userId.value}`)\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cdiv>\n    \u003Ch1>{{ user?.name }}\u003C\u002Fh1>\n  \u003C\u002Fdiv>\n\u003C\u002Ftemplate>\n```\n\n### Navigation\n\n```vue\n\u003Cscript setup>\nconst goToUser = (id: string) => {\n  navigateTo(`\u002Fusers\u002F${id}`)\n}\n\nconst goBack = () => {\n  navigateTo(-1)  \u002F\u002F Go back in history\n}\n\n\u002F\u002F With options\nconst goToLogin = () => {\n  navigateTo('\u002Flogin', {\n    replace: true,  \u002F\u002F Replace current history entry\n    external: false \u002F\u002F Internal navigation\n  })\n}\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003C!-- Declarative navigation -->\n  \u003CNuxtLink to=\"\u002Fabout\">About\u003C\u002FNuxtLink>\n  \u003CNuxtLink :to=\"`\u002Fusers\u002F${user.id}`\">View User\u003C\u002FNuxtLink>\n\n  \u003C!-- Prefetching (default: on hover) -->\n  \u003CNuxtLink to=\"\u002Fdashboard\" prefetch>Dashboard\u003C\u002FNuxtLink>\n\n  \u003C!-- No prefetch -->\n  \u003CNuxtLink to=\"\u002Fadmin\" :prefetch=\"false\">Admin\u003C\u002FNuxtLink>\n\u003C\u002Ftemplate>\n```\n\n### Route Middleware\n\n```typescript\n\u002F\u002F app\u002Fmiddleware\u002Fauth.ts\nexport default defineNuxtRouteMiddleware((to, from) => {\n  const { isAuthenticated } = useAuth()\n\n  if (!isAuthenticated.value) {\n    return navigateTo('\u002Flogin')\n  }\n})\n```\n\n```vue\n\u003C!-- app\u002Fpages\u002Fdashboard.vue -->\n\u003Cscript setup lang=\"ts\">\ndefinePageMeta({\n  middleware: 'auth'\n})\n\u003C\u002Fscript>\n```\n\n### Global Middleware\n\n```typescript\n\u002F\u002F app\u002Fmiddleware\u002Fanalytics.global.ts\nexport default defineNuxtRouteMiddleware((to, from) => {\n  \u002F\u002F Runs on every route change\n  if (import.meta.client) {\n    window.gtag?.('event', 'page_view', {\n      page_path: to.path\n    })\n  }\n})\n```\n\n### Page Meta\n\n```vue\n\u003Cscript setup lang=\"ts\">\ndefinePageMeta({\n  title: 'Dashboard',\n  middleware: ['auth'],\n  layout: 'admin',\n  pageTransition: { name: 'fade' },\n  keepalive: true\n})\n\u003C\u002Fscript>\n```\n\n## SEO & Meta Tags\n\n### useSeoMeta (Recommended)\n\n```vue\n\u003Cscript setup lang=\"ts\">\nuseSeoMeta({\n  title: 'My Page Title',\n  description: 'Page description for search engines',\n  ogTitle: 'My Page Title',\n  ogDescription: 'Page description',\n  ogImage: 'https:\u002F\u002Fexample.com\u002Fog-image.jpg',\n  ogUrl: 'https:\u002F\u002Fexample.com\u002Fmy-page',\n  twitterCard: 'summary_large_image',\n  twitterTitle: 'My Page Title',\n  twitterDescription: 'Page description',\n  twitterImage: 'https:\u002F\u002Fexample.com\u002Fog-image.jpg'\n})\n\u003C\u002Fscript>\n```\n\n### useHead (More Control)\n\n```vue\n\u003Cscript setup lang=\"ts\">\nuseHead({\n  title: 'My Page Title',\n  meta: [\n    { name: 'description', content: 'Page description' },\n    { property: 'og:title', content: 'My Page Title' }\n  ],\n  link: [\n    { rel: 'canonical', href: 'https:\u002F\u002Fexample.com\u002Fmy-page' }\n  ],\n  script: [\n    { src: 'https:\u002F\u002Fexample.com\u002Fscript.js', defer: true }\n  ]\n})\n\u003C\u002Fscript>\n```\n\n### Dynamic Meta Tags\n\n```vue\n\u003Cscript setup lang=\"ts\">\nconst { data: post } = await useFetch(`\u002Fapi\u002Fposts\u002F${route.params.slug}`)\n\nuseSeoMeta({\n  title: () => post.value?.title,\n  description: () => post.value?.excerpt,\n  ogImage: () => post.value?.image\n})\n\u003C\u002Fscript>\n```\n\n### Title Template\n\n```typescript\n\u002F\u002F nuxt.config.ts\nexport default defineNuxtConfig({\n  app: {\n    head: {\n      titleTemplate: '%s | My App'  \u002F\u002F \"Page Title | My App\"\n    }\n  }\n})\n```\n\n## Error Handling\n\n### Error Page\n\n```vue\n\u003C!-- app\u002Ferror.vue -->\n\u003Cscript setup lang=\"ts\">\nimport type { NuxtError } from '#app'\n\nconst props = defineProps\u003C{\n  error: NuxtError\n}>()\n\nconst handleError = () => {\n  clearError({ redirect: '\u002F' })\n}\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cdiv class=\"error-page\">\n    \u003Ch1>{{ error.statusCode }}\u003C\u002Fh1>\n    \u003Cp>{{ error.message }}\u003C\u002Fp>\n    \u003Cbutton @click=\"handleError\">Go Home\u003C\u002Fbutton>\n  \u003C\u002Fdiv>\n\u003C\u002Ftemplate>\n```\n\n### Error Boundaries (Component-Level)\n\n```vue\n\u003Ctemplate>\n  \u003CNuxtErrorBoundary @error=\"handleError\">\n    \u003Ctemplate #error=\"{ error, clearError }\">\n      \u003Cdiv class=\"error-container\">\n        \u003Ch2>Something went wrong\u003C\u002Fh2>\n        \u003Cp>{{ error.message }}\u003C\u002Fp>\n        \u003Cbutton @click=\"clearError\">Try again\u003C\u002Fbutton>\n      \u003C\u002Fdiv>\n    \u003C\u002Ftemplate>\n\n    \u003C!-- Your component content -->\n    \u003CMyComponent \u002F>\n  \u003C\u002FNuxtErrorBoundary>\n\u003C\u002Ftemplate>\n\n\u003Cscript setup>\nconst handleError = (error: Error) => {\n  console.error('Component error:', error)\n  \u002F\u002F Send to error tracking service\n}\n\u003C\u002Fscript>\n```\n\n### Throwing Errors\n\n```typescript\n\u002F\u002F In pages or components\nthrow createError({\n  statusCode: 404,\n  statusMessage: 'Page Not Found',\n  fatal: true  \u002F\u002F Shows error page, stops rendering\n})\n\n\u002F\u002F Non-fatal error (shows inline)\nthrow createError({\n  statusCode: 400,\n  message: 'Invalid input'\n})\n```\n\n### API Error Handling\n\n```typescript\nconst { data, error } = await useFetch('\u002Fapi\u002Fusers')\n\nif (error.value) {\n  \u002F\u002F Handle error gracefully\n  showError({\n    statusCode: error.value.statusCode,\n    message: error.value.message\n  })\n}\n```\n\n## Common Anti-Patterns\n\n### Using process.env Instead of Runtime Config\n\n```typescript\n\u002F\u002F WRONG - Won't work in production!\nconst apiUrl = process.env.API_URL\n\n\u002F\u002F CORRECT\nconst config = useRuntimeConfig()\nconst apiUrl = config.public.apiBase\n```\n\n### Missing Middleware Guards\n\n```typescript\n\u002F\u002F WRONG - No return, middleware continues\nexport default defineNuxtRouteMiddleware((to) => {\n  const { isAuthenticated } = useAuth()\n  if (!isAuthenticated.value) {\n    navigateTo('\u002Flogin')  \u002F\u002F Missing return!\n  }\n})\n\n\u002F\u002F CORRECT\nexport default defineNuxtRouteMiddleware((to) => {\n  const { isAuthenticated } = useAuth()\n  if (!isAuthenticated.value) {\n    return navigateTo('\u002Flogin')  \u002F\u002F Return stops middleware chain\n  }\n})\n```\n\n### Non-Reactive Route Params\n\n```typescript\n\u002F\u002F WRONG - Not reactive\nconst userId = route.params.id\n\n\u002F\u002F CORRECT - Reactive\nconst userId = computed(() => route.params.id)\n```\n\n## Troubleshooting\n\n**Build Errors \u002F Type Errors:**\n```bash\nrm -rf .nuxt .output node_modules\u002F.vite && bun install && bun run dev\n```\n\n**Route Not Found:**\n- Check file is in `app\u002Fpages\u002F` (not root `pages\u002F`)\n- Verify file extension is `.vue`\n- Check for typos in dynamic params `[id].vue`\n\n**Middleware Not Running:**\n- Ensure file has `.global.ts` suffix for global middleware\n- Check `definePageMeta({ middleware: 'name' })` matches filename\n- Verify middleware returns `navigateTo()` or nothing\n\n**Meta Tags Not Updating:**\n- Use reactive values: `title: () => post.value?.title`\n- Ensure `useSeoMeta` is called in `\u003Cscript setup>`\n\n## Related Skills\n\n- **nuxt-data**: Composables, data fetching, state management\n- **nuxt-server**: Server routes, API patterns, database integration\n- **nuxt-production**: Performance, testing, deployment\n- **nuxt-ui-v4**: Nuxt UI component library\n\n## Templates Available\n\nSee `templates\u002F` directory for:\n- Production-ready `nuxt.config.ts`\n- `app.vue` with proper structure\n- Middleware examples\n\n---\n\n**Version**: 4.0.0 | **Last Updated**: 2025-12-28 | **License**: MIT\n",{"name":5,"license":15,"metadata":24,"description":7},{"author":25,"version":26,"category":27,"keywords":28,"framework":43,"last-verified":44,"framework-version":45},"Claude Skills Maintainers","4.0.0","Framework",[29,30,31,32,33,34,35,36,37,38,39,40,41,42],"Nuxt 4","nuxt.config.ts","file-based routing","pages directory","definePageMeta","useHead","useSeoMeta","error.vue","NuxtErrorBoundary","middleware","navigateTo","NuxtLink","app directory","runtime config","Nuxt",1766880000000,"4.x","main","c475fc64e94e803b50d14a791dfee8853fbb2c5c","integrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fnuxt-v4\u002Fskills\u002Fnuxt-core","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory","https:\u002F\u002Fgithub.com\u002FElogic360","2026-11-08 22:21:22",{"source":8,"skillName":5,"commands":53,"prompt":63,"zipAvailable":64},[54,57,60],{"tool":55,"command":56},"npx","npx skills add Elogic360\u002Fsoftware-factory --skill nuxt-core",{"tool":58,"command":59},"bunx","bunx skills add Elogic360\u002Fsoftware-factory --skill nuxt-core",{"tool":61,"command":62},"pnpm","pnpm dlx skills add Elogic360\u002Fsoftware-factory --skill nuxt-core","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fnuxt-v4\u002Fskills\u002Fnuxt-core\u002FSKILL.md",true,[66,72,78],{"path":67,"resourceType":68,"resourceTypeDesc":69,"sizeBytes":70,"sourceHtmlUrl":71},"templates\u002Fapp.vue","OTHER","其他",287,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fnuxt-v4\u002Fskills\u002Fnuxt-core\u002Ftemplates\u002Fapp.vue",{"path":73,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":76,"sourceHtmlUrl":77},"templates\u002Finit-nuxt-v4.sh","SCRIPT","脚本",2853,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fnuxt-v4\u002Fskills\u002Fnuxt-core\u002Ftemplates\u002Finit-nuxt-v4.sh",{"path":79,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":80,"sourceHtmlUrl":81},"templates\u002Fnuxt.config.ts",3486,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fnuxt-v4\u002Fskills\u002Fnuxt-core\u002Ftemplates\u002Fnuxt.config.ts",[83,91,98,105,112,119],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":87,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M79G206MT3J6S0GY3C45P2KV","vss-summarize-video","Use to summarize a recorded video via the LVS summarization microservice (HITL-gated) with a VLM fallback. Not for report generation or live RTSP captioning.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-summarize-video\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":87,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M79G1WN63PGRE8CKD47WEBQ5","vss-setup-video-analytics-api","Use to deploy the vss-video-analytics-api REST service standalone (config-source, data-log bind, Elasticsearch, optional Kafka). Not for full warehouse deploy.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-setup-video-analytics-api\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":87,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":19},"01M79G1S9F7VY3EF6H53PRP5AN","vss-setup-behavior-analytics","Use to deploy the vss-behavior-analytics service standalone (entrypoint, config-source, optional calibration). Not for the full warehouse deploy.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-setup-behavior-analytics\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":87,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":19},"01M79G1N1S1Y27PFZPYMNK1MTQ","vss-search-archive","Use this skill to run top-level VSS fusion search on archived video, or to ingest video files \u002F RTSP streams for search. Do NOT use for ad-hoc visual Q&A (use vss-ask-video), live captioning (use vss-deploy-dense-captioning), or video summarization and reports (use vss-summarize-video).","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-search-archive\u002FSKILL.md",[],[],{"skillNo":113,"name":114,"nameZh":6,"description":115,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":87,"licenseFileUrl":6,"sourceHtmlUrl":116,"categories":117,"keywords":118,"publishedAt":19},"01M79G1H6WN0Q6C0VCAXCZX6B7","vss-query-analytics","Use this skill when reading video-analytics metrics, incidents, alerts, and sensor data via the VA-MCP server (port 9901). Not for live VLM or incident-range narrative reports.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-query-analytics\u002FSKILL.md",[],[],{"skillNo":120,"name":121,"nameZh":6,"description":122,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":87,"licenseFileUrl":6,"sourceHtmlUrl":123,"categories":124,"keywords":125,"publishedAt":19},"01M79G1DYPNXQS7QHZ0AAF5FX5","vss-manage-video-io-storage","Use to call the VIOS REST API (sensor list, timelines, clip extraction, snapshots, add\u002Fdelete sensors and streams). Not for VLM inference or search.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-manage-video-io-storage\u002FSKILL.md",[],[]]