Nuxt
Ship Nuxt 4.3+ apps with correct server routes, file-based routing, middleware, composables, and nitro/h3 patterns from bundled references.
Overview
nuxt is an agent skill for the Build phase that applies Nuxt 4.3+ server, routing, middleware, composable, and config patterns from curated reference files.
Install
npx skills add https://github.com/onmax/nuxt-skills --skill nuxtWhat is this skill?
- Nuxt 4.3+ scope with MIT-licensed progressive guidance
- Split references: server, routing, middleware-plugins, composables, components, config
- h3 v1 helpers: validation (Zod), WebSocket, SSE on server routes
- nitropack v2 and file-based routing including route groups and definePage
- Prefer NuxtLink, NuxtImg, NuxtTime over raw HTML elements
- Targets Nuxt 4.3+ with six topical reference files
- Documents h3 v1 and nitropack v2 patterns
Adoption & trust: 6.5k installs on skills.sh; 674 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You are on Nuxt 4+ but agent suggestions still mirror old Nuxt 3 or miss nitro server route and validation patterns.
Who is it for?
Indie SaaS and full-stack solo devs actively coding Nuxt 4.3+ with server routes and modern nitro/h3 features.
Skip if: Pure static sites with no Nuxt toolchain, or teams standardized on Next.js-only workflows.
When should I use this skill?
When working on Nuxt 4+ projects—server routes, file-based routing, middleware, plugins, auto-imports, layers, and Nuxt-specific composables/components.
What do I get? / Deliverables
Implementation follows the matching reference doc—correct file-based routes, server handlers, and Nuxt-native components for your task.
- Code changes aligned to the relevant references/*.md section
- Server routes, pages, or config patches following Nuxt 4 conventions
Recommended Skills
Journey fit
Full-stack Nuxt work sits in Build when you are implementing the product surface and API layer together. Frontend is canonical because pages, layouts, and Nuxt components are the entry point; server.md covers colocated API routes.
How it compares
Framework-scoped procedural skill with split reference docs—not a generic Vue cheat sheet or a deployment MCP.
Common Questions / FAQ
Who is nuxt for?
Solo builders and small teams shipping Nuxt 4+ products who want agents to pull the right official-pattern reference per task.
When should I use nuxt?
During Build while editing server API routes, pages, middleware, plugins, composables, or nuxt.config—any Nuxt 4+ repo task listed in When to Use.
Is nuxt safe to install?
Use Prism’s Security Audits panel on this page; the skill is documentation guidance (MIT) and does not by itself execute shell or network actions.
SKILL.md
READMESKILL.md - Nuxt
# Nuxt 4+ Development Progressive guidance for Nuxt 4+ projects (v4.3+) 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](references/server.md)** - API routes, server middleware, validation (Zod), WebSocket, SSE - **[references/routing.md](references/routing.md)** - File-based routing, route groups, typed router, definePage - **[references/middleware-plugins.md](references/middleware-plugins.md)** - Route middleware, plugins, app lifecycle - **[references/nuxt-composables.md](references/nuxt-composables.md)** - Nuxt composables (useRequestURL, useFetch, navigation) - **[references/nuxt-components.md](references/nuxt-components.md)** - NuxtLink, NuxtImg, NuxtTime (prefer over HTML elements) - **[references/nuxt-config.md](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 `ts-library` skill ## Loading Files **Consider loading these reference files based on your task:** - [ ] [references/server.md](references/server.md) - if creating API endpoints or server middleware - [ ] [references/routing.md](references/routing.md) - if setting up pages, layouts, or route groups - [ ] [references/nuxt-composables.md](references/nuxt-composables.md) - if using Nuxt composables (useFetch, useRequestURL, etc.) - [ ] [references/middleware-plugins.md](references/middleware-plugins.md) - if working with middleware or plugins - [ ] [references/nuxt-components.md](references/nuxt-components.md) - if using Nuxt components (NuxtLink, NuxtImg, etc.) - [ ] [references/nuxt-config.md](references/nuxt-config.md) - if editing nuxt.config.ts - [ ] [references/project-setup.md](references/project-setup.md) - if setting up CI/ESLint/build tools **DO NOT load all files at once.** Load only what's relevant to your current task. ## Quick Start ```ts // server/api/hello.get.ts import { z } from 'zod' export default defineEventHandler(async (event) => { const { name } = await getValidatedQuery(event, z.object({ name: z.string().default('world'), }).parse) return { message: `Hello ${name}` } }) ``` ## 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 routes | Typed 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:** - Nuxt: https://nuxt.com/docs - h3 (server engine): https://v1.h3.dev/ - Nitro: https://nitro.build/ ## Token Efficiency Main skill: ~300 tokens. Each sub-file: ~800-1500 tokens. Only load