nuxt

Original🇺🇸 English
Not Translated

Use when working on Nuxt 4+ projects - provides server routes, file-based routing, middleware patterns, Nuxt-specific composables, and configuration with latest docs. Covers h3 v1 helpers (validation, WebSocket, SSE) and nitropack v2 patterns.

4installs
Added on

NPX Install

npx skill4agent add nuxt-content/nuxt-studio nuxt

SKILL.md Content

Nuxt 4+ Development

Progressive guidance for Nuxt 4+ projects with latest patterns and conventions.

When to Use

Working with:
  • Server routes (API endpoints, server middleware, server utils)
  • File-based routing (pages, layouts, route groups)
  • Nuxt middleware (route guards, navigation)
  • Nuxt plugins (app extensions)
  • Nuxt-specific features (auto-imports, layers, modules)

Available Guidance

Read specific files based on current work:
  • references/server.md - API routes, server middleware, validation (Zod), WebSocket, SSE
  • references/routing.md - File-based routing, route groups, typed router, definePage
  • references/middleware-plugins.md - Route middleware, plugins, app lifecycle
  • references/nuxt-composables.md - Nuxt composables (useRequestURL, useFetch, navigation)
  • references/nuxt-components.md - NuxtLink, NuxtImg, NuxtTime (prefer over HTML elements)
  • references/nuxt-config.md - Configuration, modules, auto-imports, layers
For Vue composables: See
vue
skill composables.md (VueUse, Composition API patterns) For UI components: use
nuxt-ui
skill For database/storage: use
nuxthub
skill For content-driven sites: use
nuxt-content
skill For creating modules: use
nuxt-modules
skill For project scaffolding/CI: use
personal-ts-setup
skill

Usage Pattern

Progressive loading - only read what you need:
  • Creating API endpoint? → references/server.md
  • Setting up pages/routing? → references/routing.md
  • Using composables/data fetching? → references/nuxt-composables.md
  • Adding middleware/plugins? → references/middleware-plugins.md
  • Configuring Nuxt? → references/nuxt-config.md
  • Setting up CI/ESLint? → references/project-setup.md
DO NOT read all files at once. Load based on context:
  • Working in
    server/
    → read server.md
  • Working in
    pages/
    or
    layouts/
    → read routing.md
  • Using
    useFetch
    ,
    useRequestURL
    , navigation → read nuxt-composables.md
  • Using
    <a>
    ,
    <img>
    ,
    <time>
    elements → read nuxt-components.md
  • Working in
    middleware/
    or
    plugins/
    → read middleware-plugins.md
  • Editing
    nuxt.config.ts
    → read nuxt-config.md

Nuxt 4 vs Older Versions

You are working with Nuxt 4+. Key differences:
Old (Nuxt 2/3)New (Nuxt 4)
<Nuxt />
<NuxtPage />
context.params
getRouterParam(event, 'name')
window.origin
useRequestURL().origin
String routesTyped router with route names
Separate layouts/Parent routes with
<slot>
If you're unsure about Nuxt 4 patterns, read the relevant guidance file first.

Latest Documentation

When to fetch latest docs:
  • New Nuxt 4 features not covered here
  • Module-specific configuration
  • Breaking changes or deprecations
  • Advanced use cases
Official sources:

Token Efficiency

Main skill: ~300 tokens. Each sub-file: ~800-1500 tokens. Only load files relevant to current task.